@carbonbox/domain 0.41.0 → 0.43.0

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_segmentConfigurations;
+var _CorporateCarbonFootprintConfiguration_facility, _CorporateCarbonFootprintConfiguration_executionPeriod, _CorporateCarbonFootprintConfiguration_baseYear, _CorporateCarbonFootprintConfiguration_segmentConfigurations;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CorporateCarbonFootprintConfiguration = void 0;
 const CarbonFootprintConfiguration_1 = require("../../../shared/domain/entities/CarbonFootprintConfiguration");
@@ -19,6 +19,7 @@ const CorporateCarbonFootprintConfigurationCollectionPeriod_1 = require("../valu
 const CorporateCarbonFootprintConfigurationName_1 = require("../value-objects/CorporateCarbonFootprintConfigurationName");
 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 CorporateCarbonFootprintConfigurationFootprintType_1 = require("../value-objects/CorporateCarbonFootprintConfigurationFootprintType");
 const CorporateCarbonFootprintConfigurationIntensityIndicatorConfigurations_1 = require("../value-objects/CorporateCarbonFootprintConfigurationIntensityIndicatorConfigurations");
@@ -73,17 +74,20 @@ class CorporateCarbonFootprintConfiguration extends CarbonFootprintConfiguration
         }, skipDomainValidation);
         _CorporateCarbonFootprintConfiguration_facility.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_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_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");
         }
     }
@@ -104,6 +108,7 @@ class CorporateCarbonFootprintConfiguration extends CarbonFootprintConfiguration
             createdByStakeholder: primitives.createdByStakeholder,
             facility: primitives.facility,
             executionPeriod: primitives.executionPeriod,
+            baseYear: primitives.baseYear,
             segmentConfigurations: primitives.segmentConfigurations,
         };
         return new CorporateCarbonFootprintConfiguration(props, true);
@@ -122,6 +127,7 @@ class CorporateCarbonFootprintConfiguration extends CarbonFootprintConfiguration
             createdByStakeholder: this.createdByStakeholder.toPrimitives(),
             facility: this.facility.toPrimitives(),
             executionPeriod: this.executionPeriod.toPrimitives(),
+            baseYear: this.baseYear.toPrimitives(),
             segmentConfigurations: this.segmentConfigurations.toPrimitives(),
         };
     }
@@ -131,9 +137,12 @@ class CorporateCarbonFootprintConfiguration extends CarbonFootprintConfiguration
     get executionPeriod() {
         return __classPrivateFieldGet(this, _CorporateCarbonFootprintConfiguration_executionPeriod, "f");
     }
+    get baseYear() {
+        return __classPrivateFieldGet(this, _CorporateCarbonFootprintConfiguration_baseYear, "f");
+    }
     get segmentConfigurations() {
         return __classPrivateFieldGet(this, _CorporateCarbonFootprintConfiguration_segmentConfigurations, "f");
     }
 }
 exports.CorporateCarbonFootprintConfiguration = CorporateCarbonFootprintConfiguration;
-_CorporateCarbonFootprintConfiguration_facility = new WeakMap(), _CorporateCarbonFootprintConfiguration_executionPeriod = new WeakMap(), _CorporateCarbonFootprintConfiguration_segmentConfigurations = new WeakMap();
+_CorporateCarbonFootprintConfiguration_facility = 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/CorporateCarbonFootprintConfigurationBaseYear.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CorporateCarbonFootprintConfigurationBaseYear = void 0;
+const BaseYear_1 = require("../../../../shared/domain/value-objects/BaseYear");
+class CorporateCarbonFootprintConfigurationBaseYear extends BaseYear_1.BaseYear {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation);
+    }
+    static create(value) {
+        return new CorporateCarbonFootprintConfigurationBaseYear(value, false);
+    }
+    static fromPrimitives(primitives) {
+        const value = {
+            startDate: primitives.startDate,
+            endDate: primitives.endDate,
+            justification: primitives.justification,
+            recalculationPolicy: primitives.recalculationPolicy,
+            significanceThresholdPercentage: primitives.significanceThresholdPercentage,
+        };
+        return new CorporateCarbonFootprintConfigurationBaseYear(value, true);
+    }
+    toPrimitives() {
+        return {
+            startDate: this.startDate,
+            endDate: this.endDate,
+            justification: this.justification,
+            recalculationPolicy: this.recalculationPolicy,
+            significanceThresholdPercentage: this.significanceThresholdPercentage,
+        };
+    }
+}
+exports.CorporateCarbonFootprintConfigurationBaseYear = CorporateCarbonFootprintConfigurationBaseYear;

package/build/carbonbox/reporting/report-instances/domain/entity/ReportInstance.js

@@ -10,12 +10,13 @@ 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 _ReportInstance_templateId, _ReportInstance_templateVersion, _ReportInstance_carbonClientId, _ReportInstance_period, _ReportInstance_filters, _ReportInstance_questionnaireAnswers, _ReportInstance_dataSnapshot, _ReportInstance_generatedContent, _ReportInstance_pdfUrl, _ReportInstance_status, _ReportInstance_approvals, _ReportInstance_aiExecutions, _ReportInstance_createdAt, _ReportInstance_updatedAt;
+var _ReportInstance_templateId, _ReportInstance_templateVersion, _ReportInstance_carbonClientId, _ReportInstance_period, _ReportInstance_filters, _ReportInstance_questionnaireAnswers, _ReportInstance_assurance, _ReportInstance_dataSnapshot, _ReportInstance_generatedContent, _ReportInstance_pdfUrl, _ReportInstance_status, _ReportInstance_approvals, _ReportInstance_aiExecutions, _ReportInstance_createdAt, _ReportInstance_updatedAt;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReportInstance = void 0;
 const AggregateRoot_1 = require("../../../../shared/domain/entities/AggregateRoot");
 const ReportInstanceId_1 = require("../value-objects/ReportInstanceId");
 const ReportInstanceStatus_1 = require("../enums/ReportInstanceStatus");
+const ReportAssurance_1 = require("../../../shared/domain/value-objects/ReportAssurance");
 const ReportInstanceCannotBeGeneratedError_1 = require("../exceptions/ReportInstanceCannotBeGeneratedError");
 const ReportInstanceCannotBeApprovedInternallyError_1 = require("../exceptions/ReportInstanceCannotBeApprovedInternallyError");
 const ReportInstanceCannotBeApprovedByClientError_1 = require("../exceptions/ReportInstanceCannotBeApprovedByClientError");
@@ -34,6 +35,7 @@ class ReportInstance extends AggregateRoot_1.AggregateRoot {
         _ReportInstance_period.set(this, void 0);
         _ReportInstance_filters.set(this, void 0);
         _ReportInstance_questionnaireAnswers.set(this, void 0);
+        _ReportInstance_assurance.set(this, void 0);
         _ReportInstance_dataSnapshot.set(this, void 0);
         _ReportInstance_generatedContent.set(this, void 0);
         _ReportInstance_pdfUrl.set(this, void 0);
@@ -48,6 +50,10 @@ class ReportInstance extends AggregateRoot_1.AggregateRoot {
         __classPrivateFieldSet(this, _ReportInstance_period, props.period, "f");
         __classPrivateFieldSet(this, _ReportInstance_filters, props.filters, "f");
         __classPrivateFieldSet(this, _ReportInstance_questionnaireAnswers, props.questionnaireAnswers, "f");
+        // GAP 6: the declaration is validated on create (invariants between level, type and verifier)
+        __classPrivateFieldSet(this, _ReportInstance_assurance, skipDomainValidation
+            ? ReportAssurance_1.ReportAssurance.fromPrimitives(props.assurance)
+            : ReportAssurance_1.ReportAssurance.create(props.assurance), "f");
         __classPrivateFieldSet(this, _ReportInstance_dataSnapshot, props.dataSnapshot, "f");
         __classPrivateFieldSet(this, _ReportInstance_generatedContent, props.generatedContent, "f");
         __classPrivateFieldSet(this, _ReportInstance_pdfUrl, props.pdfUrl, "f");
@@ -80,6 +86,7 @@ class ReportInstance extends AggregateRoot_1.AggregateRoot {
             period: primitives.period,
             filters: primitives.filters,
             questionnaireAnswers: primitives.questionnaireAnswers,
+            assurance: primitives.assurance,
             dataSnapshot: primitives.dataSnapshot,
             generatedContent: primitives.generatedContent,
             pdfUrl: primitives.pdfUrl,
@@ -100,6 +107,7 @@ class ReportInstance extends AggregateRoot_1.AggregateRoot {
             period: __classPrivateFieldGet(this, _ReportInstance_period, "f"),
             filters: __classPrivateFieldGet(this, _ReportInstance_filters, "f"),
             questionnaireAnswers: __classPrivateFieldGet(this, _ReportInstance_questionnaireAnswers, "f"),
+            assurance: __classPrivateFieldGet(this, _ReportInstance_assurance, "f").toPrimitives(),
             dataSnapshot: __classPrivateFieldGet(this, _ReportInstance_dataSnapshot, "f"),
             generatedContent: __classPrivateFieldGet(this, _ReportInstance_generatedContent, "f"),
             pdfUrl: __classPrivateFieldGet(this, _ReportInstance_pdfUrl, "f"),
@@ -119,6 +127,7 @@ class ReportInstance extends AggregateRoot_1.AggregateRoot {
             period: __classPrivateFieldGet(this, _ReportInstance_period, "f"),
             filters: __classPrivateFieldGet(this, _ReportInstance_filters, "f"),
             questionnaireAnswers: __classPrivateFieldGet(this, _ReportInstance_questionnaireAnswers, "f"),
+            assurance: __classPrivateFieldGet(this, _ReportInstance_assurance, "f").toPrimitives(),
             dataSnapshot: __classPrivateFieldGet(this, _ReportInstance_dataSnapshot, "f"),
             generatedContent: __classPrivateFieldGet(this, _ReportInstance_generatedContent, "f"),
             pdfUrl: __classPrivateFieldGet(this, _ReportInstance_pdfUrl, "f"),
@@ -151,6 +160,9 @@ class ReportInstance extends AggregateRoot_1.AggregateRoot {
     getQuestionnaireAnswers() {
         return [...__classPrivateFieldGet(this, _ReportInstance_questionnaireAnswers, "f")];
     }
+    getAssurance() {
+        return __classPrivateFieldGet(this, _ReportInstance_assurance, "f").toPrimitives();
+    }
     getDataSnapshot() {
         return __classPrivateFieldGet(this, _ReportInstance_dataSnapshot, "f");
     }
@@ -363,6 +375,10 @@ class ReportInstance extends AggregateRoot_1.AggregateRoot {
         // For now, we assume client approval is always required
         return true;
     }
+    /** GAP 6: whether the inventory of this report was verified (limited or reasonable assurance). */
+    isVerified() {
+        return __classPrivateFieldGet(this, _ReportInstance_assurance, "f").isVerified();
+    }
     getApprovalCount() {
         return __classPrivateFieldGet(this, _ReportInstance_approvals, "f").length;
     }
@@ -381,4 +397,4 @@ class ReportInstance extends AggregateRoot_1.AggregateRoot {
     }
 }
 exports.ReportInstance = ReportInstance;
-_ReportInstance_templateId = new WeakMap(), _ReportInstance_templateVersion = new WeakMap(), _ReportInstance_carbonClientId = new WeakMap(), _ReportInstance_period = new WeakMap(), _ReportInstance_filters = new WeakMap(), _ReportInstance_questionnaireAnswers = new WeakMap(), _ReportInstance_dataSnapshot = new WeakMap(), _ReportInstance_generatedContent = new WeakMap(), _ReportInstance_pdfUrl = new WeakMap(), _ReportInstance_status = new WeakMap(), _ReportInstance_approvals = new WeakMap(), _ReportInstance_aiExecutions = new WeakMap(), _ReportInstance_createdAt = new WeakMap(), _ReportInstance_updatedAt = new WeakMap();
+_ReportInstance_templateId = new WeakMap(), _ReportInstance_templateVersion = new WeakMap(), _ReportInstance_carbonClientId = new WeakMap(), _ReportInstance_period = new WeakMap(), _ReportInstance_filters = new WeakMap(), _ReportInstance_questionnaireAnswers = new WeakMap(), _ReportInstance_assurance = new WeakMap(), _ReportInstance_dataSnapshot = new WeakMap(), _ReportInstance_generatedContent = new WeakMap(), _ReportInstance_pdfUrl = new WeakMap(), _ReportInstance_status = new WeakMap(), _ReportInstance_approvals = new WeakMap(), _ReportInstance_aiExecutions = new WeakMap(), _ReportInstance_createdAt = new WeakMap(), _ReportInstance_updatedAt = new WeakMap();

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

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssuranceLevel = void 0;
+/**
+ * Assurance level enumeration (ISO 14064-3)
+ * Level of assurance a GHG inventory verification provides, as declared on a report instance
+ * (ISO 14064-1 §9.3.1: the report states whether the inventory was verified and at which level)
+ */
+var AssuranceLevel;
+(function (AssuranceLevel) {
+    /**
+     * The inventory of the reporting period has not been verified
+     */
+    AssuranceLevel["NONE"] = "NONE";
+    /**
+     * Limited assurance: the verifier found nothing indicating the inventory is materially misstated
+     */
+    AssuranceLevel["LIMITED"] = "LIMITED";
+    /**
+     * Reasonable assurance: the verifier affirms the inventory is fairly stated (higher evidence)
+     */
+    AssuranceLevel["REASONABLE"] = "REASONABLE";
+})(AssuranceLevel || (exports.AssuranceLevel = AssuranceLevel = {}));

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

@@ -52,6 +52,20 @@ var DataBindingSource;
     DataBindingSource["AGGREGATION_UNCERTAINTY_RANGE_MIN_TCO2E"] = "aggregation.uncertainty.rangeMinTCO2e";
     DataBindingSource["AGGREGATION_UNCERTAINTY_RANGE_MAX_TCO2E"] = "aggregation.uncertainty.rangeMaxTCO2e";
     DataBindingSource["AGGREGATION_UNCERTAINTY_BY_SOURCE"] = "aggregation.uncertainty.bySource";
+    // Base year and recalculation policy (GAP 3, ISO 14064-1 §6.4): declared on the corporate
+    // configuration and frozen into the snapshot with the base-year total and the variation
+    DataBindingSource["BASE_YEAR_PERIOD"] = "baseYear.period";
+    DataBindingSource["BASE_YEAR_TOTAL_TCO2E"] = "baseYear.totalTCO2e";
+    DataBindingSource["BASE_YEAR_VARIATION_PERCENTAGE"] = "baseYear.variationPercentage";
+    DataBindingSource["BASE_YEAR_JUSTIFICATION"] = "baseYear.justification";
+    DataBindingSource["BASE_YEAR_RECALCULATION_POLICY"] = "baseYear.recalculationPolicy";
+    DataBindingSource["BASE_YEAR_SIGNIFICANCE_THRESHOLD_PERCENTAGE"] = "baseYear.significanceThresholdPercentage";
+    // Assurance (GAP 6, ISO 14064-1 §9.3.1): whether the inventory was verified, by which party and
+    // with which level of assurance, as declared on the report instance (not part of the snapshot)
+    DataBindingSource["ASSURANCE_LEVEL"] = "assurance.level";
+    DataBindingSource["ASSURANCE_VERIFICATION_TYPE"] = "assurance.verificationType";
+    DataBindingSource["ASSURANCE_VERIFIER"] = "assurance.verifier";
+    DataBindingSource["ASSURANCE_STATEMENT"] = "assurance.statement";
     // Emission Factors
     DataBindingSource["EMISSION_FACTOR_VALUE"] = "emissionFactor.value";
     DataBindingSource["EMISSION_FACTOR_UNIT"] = "emissionFactor.unit";
@@ -80,6 +94,7 @@ var DataBindingSource;
     DataBindingSource["CHART_BY_GAS"] = "chart.byGas";
     DataBindingSource["CHART_TREND_ANALYSIS"] = "chart.trendAnalysis";
     DataBindingSource["CHART_UNCERTAINTY_BY_SOURCE"] = "chart.uncertaintyBySource";
+    DataBindingSource["CHART_BASE_YEAR_COMPARISON"] = "chart.baseYearComparison";
     // Facilities/Locations
     DataBindingSource["FACILITIES_COUNT"] = "facilities.count";
     DataBindingSource["FACILITIES_LIST"] = "facilities.list";

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

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VerificationType = void 0;
+/**
+ * Verification type enumeration (ISO 14064-3 / ISO 17029 party types)
+ * Who performed the verification of the GHG inventory declared on a report instance
+ */
+var VerificationType;
+(function (VerificationType) {
+    /**
+     * First-party: internal verification by the organization itself
+     */
+    VerificationType["FIRST_PARTY"] = "FIRST_PARTY";
+    /**
+     * Second-party: verification by a party with a user interest (customer, group company)
+     */
+    VerificationType["SECOND_PARTY"] = "SECOND_PARTY";
+    /**
+     * Third-party: verification by an independent body
+     */
+    VerificationType["THIRD_PARTY"] = "THIRD_PARTY";
+})(VerificationType || (exports.VerificationType = VerificationType = {}));

package/build/carbonbox/reporting/shared/domain/exceptions/InvalidReportAssuranceError.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidReportAssuranceError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class InvalidReportAssuranceError extends CodedRootError_1.CodedRootError {
+    constructor(reason) {
+        const technicalMessage = `Invalid report assurance declaration: ${reason}`;
+        const context = {
+            reason,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'level must be a value of AssuranceLevel (NONE, LIMITED, REASONABLE)',
+            'With level NONE, verificationType and verifierName must be null',
+            'With level LIMITED or REASONABLE, verificationType must be a value of VerificationType and verifierName a non-empty name',
+            'Review the assurance declaration of the report instance',
+        ];
+        super(ErrorCode_1.ErrorCode.INVALID_REPORT_ASSURANCE, technicalMessage, context, suggestions);
+        this.name = 'InvalidReportAssuranceError';
+    }
+    static create(reason) {
+        return new InvalidReportAssuranceError(reason);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.InvalidReportAssuranceError = InvalidReportAssuranceError;

package/build/carbonbox/reporting/shared/domain/types/ReportAssurancePrimitives.js

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

package/build/carbonbox/reporting/shared/domain/value-objects/ReportAssurance.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportAssurance = void 0;
+const ValueObject_1 = require("../../../../shared/domain/value-objects/ValueObject");
+const AssuranceLevel_1 = require("../enums/AssuranceLevel");
+const VerificationType_1 = require("../enums/VerificationType");
+const InvalidReportAssuranceError_1 = require("../exceptions/InvalidReportAssuranceError");
+/**
+ * Assurance declaration of a report instance (GAP 6, ISO 14064-1 §9.3.1 / ISO 14064-3).
+ * Invariants: with level NONE nothing else is declared; with LIMITED or REASONABLE the
+ * verification type and the verifier name are mandatory.
+ */
+class ReportAssurance extends ValueObject_1.ValueObject {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, ReportAssurance.PROPERTY_NAME, ReportAssurance.EXPECTED_TYPE);
+        if (!skipDomainValidation) {
+            this.validateReportAssurance(value);
+        }
+    }
+    static create(value) {
+        return new ReportAssurance(value, false);
+    }
+    static fromPrimitives(primitives) {
+        return new ReportAssurance(primitives, true);
+    }
+    static notVerified() {
+        return new ReportAssurance({ level: AssuranceLevel_1.AssuranceLevel.NONE, verificationType: null, verifierName: null }, false);
+    }
+    validateReportAssurance(value) {
+        if (!Object.values(AssuranceLevel_1.AssuranceLevel).includes(value.level)) {
+            throw InvalidReportAssuranceError_1.InvalidReportAssuranceError.create(`level '${String(value.level)}' is not a value of AssuranceLevel`);
+        }
+        if (value.level === AssuranceLevel_1.AssuranceLevel.NONE) {
+            if (value.verificationType !== null) {
+                throw InvalidReportAssuranceError_1.InvalidReportAssuranceError.create('verificationType must be null when the inventory is not verified (level NONE)');
+            }
+            if (value.verifierName !== null) {
+                throw InvalidReportAssuranceError_1.InvalidReportAssuranceError.create('verifierName must be null when the inventory is not verified (level NONE)');
+            }
+            return;
+        }
+        if (value.verificationType === null || !Object.values(VerificationType_1.VerificationType).includes(value.verificationType)) {
+            throw InvalidReportAssuranceError_1.InvalidReportAssuranceError.create(`verificationType '${String(value.verificationType)}' is required with level ${value.level} and must be a value of VerificationType`);
+        }
+        if (typeof value.verifierName !== 'string' || value.verifierName.trim() === '') {
+            throw InvalidReportAssuranceError_1.InvalidReportAssuranceError.create(`verifierName is required with level ${value.level}`);
+        }
+        if (value.verifierName.trim().length > ReportAssurance.VERIFIER_NAME_MAX_LENGTH) {
+            throw InvalidReportAssuranceError_1.InvalidReportAssuranceError.create(`verifierName cannot exceed ${ReportAssurance.VERIFIER_NAME_MAX_LENGTH} characters`);
+        }
+    }
+    getLevel() {
+        return this.value.level;
+    }
+    getVerificationType() {
+        return this.value.verificationType;
+    }
+    getVerifierName() {
+        return this.value.verifierName;
+    }
+    isVerified() {
+        return this.value.level !== AssuranceLevel_1.AssuranceLevel.NONE;
+    }
+    isIndependentlyVerified() {
+        return this.value.verificationType === VerificationType_1.VerificationType.THIRD_PARTY;
+    }
+    toPrimitives() {
+        return {
+            level: this.value.level,
+            verificationType: this.value.verificationType,
+            verifierName: this.value.verifierName === null ? null : this.value.verifierName.trim(),
+        };
+    }
+}
+exports.ReportAssurance = ReportAssurance;
+ReportAssurance.PROPERTY_NAME = 'reportAssurance';
+ReportAssurance.EXPECTED_TYPE = 'ReportAssurancePrimitives';
+ReportAssurance.VERIFIER_NAME_MAX_LENGTH = 255;

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

@@ -163,6 +163,7 @@ var ErrorCode;
     ErrorCode["REPORT_PREPARATION_QUESTIONNAIRE_CANNOT_BE_REOPENED"] = "CBX-RPT-025";
     ErrorCode["INVALID_PREPARATION_QUESTION"] = "CBX-RPT-026";
     ErrorCode["INVALID_REPORT_BLOCK_DATA_BINDING"] = "CBX-RPT-027";
+    ErrorCode["INVALID_REPORT_ASSURANCE"] = "CBX-RPT-028";
     // Shared/Common Errors (CBX-SHR-XXX)
     ErrorCode["INVALID_EMAIL"] = "CBX-SHR-001";
     ErrorCode["INVALID_DATE_FORMAT"] = "CBX-SHR-002";

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

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

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

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

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

@@ -0,0 +1,156 @@
+"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 _BaseYear_startDate, _BaseYear_endDate, _BaseYear_justification, _BaseYear_recalculationPolicy, _BaseYear_significanceThresholdPercentage;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseYear = void 0;
+const InvalidPropertyTypeError_1 = require("../exceptions/InvalidPropertyTypeError");
+const InvalidPropertyValueError_1 = require("../exceptions/InvalidPropertyValueError");
+const DateString_1 = require("./DateString");
+const ObjectValueObject_1 = require("./ObjectValueObject");
+const String_1 = require("./String");
+/**
+ * Base year of a GHG inventory (ISO 14064-1 §6.4 / GHG Protocol "base year and recalculation
+ * policy", GAP 3). Modelled as a DATE RANGE rather than a calendar year so fiscal years
+ * (e.g. 1 July 2025 – 30 June 2026) are first-class. Carries the organization's justification
+ * for the choice, its recalculation policy and the significance threshold that triggers a
+ * recalculation. Immutable; subclasses give it an aggregate-specific name.
+ */
+class BaseYear 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 = BaseYear.DEFAULT_PROPERTY_NAME) {
+        super(value, skipDomainValidation, propertyName, 'The provided value must be of type BaseYear from the domain layer', { allowNull: false, allowUndefined: false });
+        _BaseYear_startDate.set(this, void 0);
+        _BaseYear_endDate.set(this, void 0);
+        _BaseYear_justification.set(this, void 0);
+        _BaseYear_recalculationPolicy.set(this, void 0);
+        _BaseYear_significanceThresholdPercentage.set(this, void 0);
+        if (skipDomainValidation === false) {
+            this.guardAgainstInvalidBaseYear(value);
+        }
+        __classPrivateFieldSet(this, _BaseYear_startDate, value.startDate, "f");
+        __classPrivateFieldSet(this, _BaseYear_endDate, value.endDate, "f");
+        __classPrivateFieldSet(this, _BaseYear_justification, value.justification, "f");
+        __classPrivateFieldSet(this, _BaseYear_recalculationPolicy, value.recalculationPolicy, "f");
+        __classPrivateFieldSet(this, _BaseYear_significanceThresholdPercentage, value.significanceThresholdPercentage, "f");
+    }
+    guardAgainstInvalidBaseYear(value) {
+        this.guardAgainstInvalidDate(value.startDate, 'startDate');
+        this.guardAgainstInvalidDate(value.endDate, 'endDate');
+        this.guardAgainstInvalidDateRange(value.startDate, value.endDate);
+        this.guardAgainstInvalidText(value.justification, 'justification');
+        this.guardAgainstInvalidText(value.recalculationPolicy, 'recalculationPolicy');
+        this.guardAgainstInvalidSignificanceThreshold(value.significanceThresholdPercentage);
+    }
+    guardAgainstInvalidDate(date, propertyName) {
+        this.guardAgainstNullOrUndefinedValue(date, propertyName);
+        String_1.String.guardAgainstInvalidType(date, propertyName);
+        String_1.String.guardAgainstEmptyValue(date, propertyName);
+        DateString_1.DateString.guardAgainstInvalidDateFormat(date);
+    }
+    guardAgainstInvalidText(text, propertyName) {
+        this.guardAgainstNullOrUndefinedValue(text, propertyName);
+        String_1.String.guardAgainstInvalidType(text, propertyName);
+        String_1.String.guardAgainstEmptyValue(text, propertyName);
+    }
+    guardAgainstInvalidDateRange(startDate, endDate) {
+        const start = this.parseDate(startDate);
+        const end = this.parseDate(endDate);
+        if (start >= end) {
+            throw InvalidPropertyValueError_1.InvalidPropertyValueError.create('endDate', 'date after start date', `start: ${startDate}, end: ${endDate}`);
+        }
+    }
+    guardAgainstInvalidSignificanceThreshold(percentage) {
+        this.guardAgainstNullOrUndefinedValue(percentage, 'significanceThresholdPercentage');
+        if (typeof percentage !== 'number' || Number.isNaN(percentage) || !Number.isFinite(percentage)) {
+            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create('significanceThresholdPercentage', 'finite number', typeof percentage);
+        }
+        if (percentage < BaseYear.MIN_SIGNIFICANCE_THRESHOLD_PERCENTAGE || percentage > BaseYear.MAX_SIGNIFICANCE_THRESHOLD_PERCENTAGE) {
+            throw InvalidPropertyValueError_1.InvalidPropertyValueError.create('significanceThresholdPercentage', `percentage between ${BaseYear.MIN_SIGNIFICANCE_THRESHOLD_PERCENTAGE} and ${BaseYear.MAX_SIGNIFICANCE_THRESHOLD_PERCENTAGE}`, `${percentage}`);
+        }
+    }
+    guardAgainstNullOrUndefinedValue(value, propertyName) {
+        if (value === null || value === undefined) {
+            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(propertyName, 'non-null value', typeof value);
+        }
+    }
+    parseDate(dateString) {
+        const [day, month, year] = dateString.split('/').map(Number);
+        return new Date(year, month - 1, day);
+    }
+    // Getters
+    get startDate() {
+        return __classPrivateFieldGet(this, _BaseYear_startDate, "f");
+    }
+    get endDate() {
+        return __classPrivateFieldGet(this, _BaseYear_endDate, "f");
+    }
+    get justification() {
+        return __classPrivateFieldGet(this, _BaseYear_justification, "f");
+    }
+    get recalculationPolicy() {
+        return __classPrivateFieldGet(this, _BaseYear_recalculationPolicy, "f");
+    }
+    get significanceThresholdPercentage() {
+        return __classPrivateFieldGet(this, _BaseYear_significanceThresholdPercentage, "f");
+    }
+    toPrimitives() {
+        return {
+            startDate: __classPrivateFieldGet(this, _BaseYear_startDate, "f"),
+            endDate: __classPrivateFieldGet(this, _BaseYear_endDate, "f"),
+            justification: __classPrivateFieldGet(this, _BaseYear_justification, "f"),
+            recalculationPolicy: __classPrivateFieldGet(this, _BaseYear_recalculationPolicy, "f"),
+            significanceThresholdPercentage: __classPrivateFieldGet(this, _BaseYear_significanceThresholdPercentage, "f"),
+        };
+    }
+    // Domain methods
+    getStartDateAsDate() {
+        return this.parseDate(__classPrivateFieldGet(this, _BaseYear_startDate, "f"));
+    }
+    getEndDateAsDate() {
+        return this.parseDate(__classPrivateFieldGet(this, _BaseYear_endDate, "f"));
+    }
+    /** `DD/MM/YYYY to DD/MM/YYYY`, the label reports print next to the base-year figures. */
+    getShortFormattedRange() {
+        return `${__classPrivateFieldGet(this, _BaseYear_startDate, "f")} to ${__classPrivateFieldGet(this, _BaseYear_endDate, "f")}`;
+    }
+    /** True when the base year is not a calendar year (starts on a day other than 1 January). */
+    isFiscalYear() {
+        const start = this.getStartDateAsDate();
+        return start.getMonth() !== 0 || start.getDate() !== 1;
+    }
+    /** Whether a change of the given magnitude (± %) must trigger a base-year recalculation. */
+    requiresRecalculation(changePercentage) {
+        return Math.abs(changePercentage) >= __classPrivateFieldGet(this, _BaseYear_significanceThresholdPercentage, "f");
+    }
+    containsDate(date) {
+        return date >= this.getStartDateAsDate() && date <= this.getEndDateAsDate();
+    }
+    coversSamePeriodAs(startDate, endDate) {
+        return __classPrivateFieldGet(this, _BaseYear_startDate, "f") === startDate && __classPrivateFieldGet(this, _BaseYear_endDate, "f") === endDate;
+    }
+    equals(other) {
+        return __classPrivateFieldGet(this, _BaseYear_startDate, "f") === __classPrivateFieldGet(other, _BaseYear_startDate, "f")
+            && __classPrivateFieldGet(this, _BaseYear_endDate, "f") === __classPrivateFieldGet(other, _BaseYear_endDate, "f")
+            && __classPrivateFieldGet(this, _BaseYear_justification, "f") === __classPrivateFieldGet(other, _BaseYear_justification, "f")
+            && __classPrivateFieldGet(this, _BaseYear_recalculationPolicy, "f") === __classPrivateFieldGet(other, _BaseYear_recalculationPolicy, "f")
+            && __classPrivateFieldGet(this, _BaseYear_significanceThresholdPercentage, "f") === __classPrivateFieldGet(other, _BaseYear_significanceThresholdPercentage, "f");
+    }
+}
+exports.BaseYear = BaseYear;
+_BaseYear_startDate = new WeakMap(), _BaseYear_endDate = new WeakMap(), _BaseYear_justification = new WeakMap(), _BaseYear_recalculationPolicy = new WeakMap(), _BaseYear_significanceThresholdPercentage = new WeakMap();
+BaseYear.DEFAULT_PROPERTY_NAME = 'baseYear';
+BaseYear.MIN_SIGNIFICANCE_THRESHOLD_PERCENTAGE = 0;
+BaseYear.MAX_SIGNIFICANCE_THRESHOLD_PERCENTAGE = 100;