@carbonbox/domain 0.40.0 → 0.42.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/emission-calculation-results/emission-aggregations/domain/value-objects/EmissionAggregationUncertaintyPercentage.js

@@ -7,10 +7,12 @@ class EmissionAggregationUncertaintyPercentage extends Numeric_1.Numeric {
         super(value, skipDomainValidation, EmissionAggregationUncertaintyPercentage.PROPERTY_NAME, {
             minValue: 0,
             maxValue: 100,
-            allowDecimals: false,
+            allowDecimals: true,
             allowNegative: false,
             allowZero: true,
-            maxDecimalPlaces: 0, // No decimals for percentage
+            // GAP 4: same precision as the per-calculation uncertainty VOs, so a propagated
+            // value (e.g. 11.18034 %) is not truncated to an integer when aggregated.
+            maxDecimalPlaces: 5,
         });
     }
     static create(value) {

package/build/carbonbox/emission-calculation-results/shared/domain/enums/UncertaintyLevel.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UncertaintyLevel = void 0;
+/**
+ * Qualitative band of an uncertainty percentage (GAP 4).
+ *
+ * Thresholds follow the scale used by verified ISO 14064-1 inventories (GHG Protocol
+ * uncertainty tool): LOW ≤ 5 %, REGULAR ≤ 15 %, FAIR ≤ 30 %, HIGH > 30 %.
+ * `UncertaintyPropagationDomainService.classify` is the single place that applies them.
+ */
+var UncertaintyLevel;
+(function (UncertaintyLevel) {
+    UncertaintyLevel["LOW"] = "LOW";
+    UncertaintyLevel["REGULAR"] = "REGULAR";
+    UncertaintyLevel["FAIR"] = "FAIR";
+    UncertaintyLevel["HIGH"] = "HIGH";
+})(UncertaintyLevel || (exports.UncertaintyLevel = UncertaintyLevel = {}));

package/build/carbonbox/emission-calculation-results/shared/domain/services/contracts/IUncertaintyPropagationDomainService.js

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

package/build/carbonbox/emission-calculation-results/shared/domain/services/implementations/UncertaintyPropagationDomainService.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UncertaintyPropagationDomainService = void 0;
+const UncertaintyLevel_1 = require("../../enums/UncertaintyLevel");
+/**
+ * Domain Service for uncertainty propagation across the emission-calculation-results
+ * context (GAP 4). Centralizes the GHG Protocol "Method 1" arithmetic that used to live
+ * in the calculation worker, so the worker, the report snapshot builder and any future
+ * aggregation job apply the same formulas and the same qualitative scale.
+ *
+ * Stateless: created through the factory and registered as a singleton.
+ */
+class UncertaintyPropagationDomainService {
+    constructor() {
+        // Private constructor to enforce factory pattern
+    }
+    static create() {
+        return new UncertaintyPropagationDomainService();
+    }
+    combineIndependent(uncertaintyPercentages) {
+        const sumOfSquares = uncertaintyPercentages.reduce((sum, percentage) => sum + percentage ** 2, 0);
+        return Math.sqrt(sumOfSquares);
+    }
+    combineWeighted(contributions) {
+        const totalMagnitude = contributions.reduce((sum, contribution) => sum + Math.abs(contribution.value), 0);
+        if (totalMagnitude === 0) {
+            return 0;
+        }
+        const sumOfSquaredAbsoluteUncertainties = contributions.reduce((sum, contribution) => sum + (contribution.value * contribution.uncertaintyPercentage) ** 2, 0);
+        return Math.sqrt(sumOfSquaredAbsoluteUncertainties) / totalMagnitude;
+    }
+    classify(uncertaintyPercentage) {
+        if (uncertaintyPercentage <= UncertaintyPropagationDomainService.LOW_UPPER_BOUND_PERCENTAGE) {
+            return UncertaintyLevel_1.UncertaintyLevel.LOW;
+        }
+        if (uncertaintyPercentage <= UncertaintyPropagationDomainService.REGULAR_UPPER_BOUND_PERCENTAGE) {
+            return UncertaintyLevel_1.UncertaintyLevel.REGULAR;
+        }
+        if (uncertaintyPercentage <= UncertaintyPropagationDomainService.FAIR_UPPER_BOUND_PERCENTAGE) {
+            return UncertaintyLevel_1.UncertaintyLevel.FAIR;
+        }
+        return UncertaintyLevel_1.UncertaintyLevel.HIGH;
+    }
+    boundsOf(centralValue, uncertaintyPercentage) {
+        const absoluteUncertainty = (centralValue * uncertaintyPercentage) / 100;
+        return {
+            min: Math.max(0, centralValue - absoluteUncertainty),
+            max: centralValue + absoluteUncertainty,
+        };
+    }
+}
+exports.UncertaintyPropagationDomainService = UncertaintyPropagationDomainService;
+UncertaintyPropagationDomainService.LOW_UPPER_BOUND_PERCENTAGE = 5;
+UncertaintyPropagationDomainService.REGULAR_UPPER_BOUND_PERCENTAGE = 15;
+UncertaintyPropagationDomainService.FAIR_UPPER_BOUND_PERCENTAGE = 30;

package/build/carbonbox/emission-calculation-results/shared/domain/types/UncertaintyBounds.js

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

package/build/carbonbox/emission-calculation-results/shared/domain/types/UncertaintyWeightedContribution.js

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

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

@@ -46,6 +46,20 @@ var DataBindingSource;
     // Aggregations - Biogenic
     DataBindingSource["AGGREGATION_BIOGENIC"] = "aggregation.biogenic";
     DataBindingSource["AGGREGATION_BIOGENIC_CO2"] = "aggregation.biogenicCO2";
+    // Aggregations - Uncertainty (GAP 4): inventory-level propagated uncertainty
+    DataBindingSource["AGGREGATION_UNCERTAINTY_PERCENTAGE"] = "aggregation.uncertainty.percentage";
+    DataBindingSource["AGGREGATION_UNCERTAINTY_LEVEL"] = "aggregation.uncertainty.level";
+    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";
     // Emission Factors
     DataBindingSource["EMISSION_FACTOR_VALUE"] = "emissionFactor.value";
     DataBindingSource["EMISSION_FACTOR_UNIT"] = "emissionFactor.unit";
@@ -55,6 +69,7 @@ var DataBindingSource;
     DataBindingSource["EMISSION_FACTOR_IPCC_CODE"] = "emissionFactor.ipccCode";
     DataBindingSource["EMISSION_FACTOR_IPCC_SUBCATEGORY"] = "emissionFactor.ipccSubcategory";
     DataBindingSource["EMISSION_FACTOR_METHODOLOGICAL_TIER"] = "emissionFactor.methodologicalTier";
+    DataBindingSource["EMISSION_FACTOR_UNCERTAINTY_PERCENTAGE"] = "emissionFactor.uncertaintyPercentage";
     // Global Warming Potential (GWP)
     DataBindingSource["GWP_PROTOCOL_VERSION"] = "gwp.protocolVersion";
     DataBindingSource["GWP_POTENTIAL"] = "gwp.potential";
@@ -72,6 +87,8 @@ var DataBindingSource;
     DataBindingSource["CHART_BY_SEGMENT"] = "chart.bySegment";
     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/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;