@carbonbox/domain 0.36.1 → 0.38.0

package/build/carbonbox/emission-calculation-formulas/emission-factors/domain/entity/EmissionFactor.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 _EmissionFactor_code, _EmissionFactor_name, _EmissionFactor_description, _EmissionFactor_greenhouseGasValues, _EmissionFactor_informationSource;
+var _EmissionFactor_code, _EmissionFactor_name, _EmissionFactor_description, _EmissionFactor_greenhouseGasValues, _EmissionFactor_informationSource, _EmissionFactor_ipccCode, _EmissionFactor_ipccSubcategory, _EmissionFactor_methodologicalTier;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EmissionFactor = void 0;
 const AggregateRoot_1 = require("../../../../shared/domain/entities/AggregateRoot");
@@ -19,6 +19,9 @@ const EmissionFactorDescription_1 = require("../value-objects/EmissionFactorDesc
 const EmissionFactorGreenhouseGasValues_1 = require("../value-objects/EmissionFactorGreenhouseGasValues");
 const EmissionFactorId_1 = require("../value-objects/EmissionFactorId");
 const EmissionFactorInformationSource_1 = require("../value-objects/EmissionFactorInformationSource");
+const EmissionFactorIpccCode_1 = require("../value-objects/EmissionFactorIpccCode");
+const EmissionFactorIpccSubcategory_1 = require("../value-objects/EmissionFactorIpccSubcategory");
+const EmissionFactorMethodologicalTier_1 = require("../value-objects/EmissionFactorMethodologicalTier");
 const EmissionFactorName_1 = require("../value-objects/EmissionFactorName");
 class EmissionFactor extends AggregateRoot_1.AggregateRoot {
     constructor(props, skipDomainValidation) {
@@ -31,6 +34,9 @@ class EmissionFactor extends AggregateRoot_1.AggregateRoot {
         _EmissionFactor_description.set(this, void 0);
         _EmissionFactor_greenhouseGasValues.set(this, void 0);
         _EmissionFactor_informationSource.set(this, void 0);
+        _EmissionFactor_ipccCode.set(this, void 0);
+        _EmissionFactor_ipccSubcategory.set(this, void 0);
+        _EmissionFactor_methodologicalTier.set(this, void 0);
         if (skipDomainValidation === false) {
             // Initialize with domain validation
             __classPrivateFieldSet(this, _EmissionFactor_code, EmissionFactorCode_1.EmissionFactorCode.create(props.code), "f");
@@ -38,6 +44,9 @@ class EmissionFactor extends AggregateRoot_1.AggregateRoot {
             __classPrivateFieldSet(this, _EmissionFactor_description, EmissionFactorDescription_1.EmissionFactorDescription.create(props.description), "f");
             __classPrivateFieldSet(this, _EmissionFactor_greenhouseGasValues, EmissionFactorGreenhouseGasValues_1.EmissionFactorGreenhouseGasValues.create(props.greenhouseGasValues), "f");
             __classPrivateFieldSet(this, _EmissionFactor_informationSource, EmissionFactorInformationSource_1.EmissionFactorInformationSource.create(props.informationSource), "f");
+            __classPrivateFieldSet(this, _EmissionFactor_ipccCode, EmissionFactorIpccCode_1.EmissionFactorIpccCode.create(props.ipccCode), "f");
+            __classPrivateFieldSet(this, _EmissionFactor_ipccSubcategory, EmissionFactorIpccSubcategory_1.EmissionFactorIpccSubcategory.create(props.ipccSubcategory), "f");
+            __classPrivateFieldSet(this, _EmissionFactor_methodologicalTier, EmissionFactorMethodologicalTier_1.EmissionFactorMethodologicalTier.create(props.methodologicalTier), "f");
         }
         else {
             // Initialize from primitives (no domain validation)
@@ -46,6 +55,9 @@ class EmissionFactor extends AggregateRoot_1.AggregateRoot {
             __classPrivateFieldSet(this, _EmissionFactor_description, EmissionFactorDescription_1.EmissionFactorDescription.fromPrimitives(props.description), "f");
             __classPrivateFieldSet(this, _EmissionFactor_greenhouseGasValues, EmissionFactorGreenhouseGasValues_1.EmissionFactorGreenhouseGasValues.fromPrimitives(props.greenhouseGasValues), "f");
             __classPrivateFieldSet(this, _EmissionFactor_informationSource, EmissionFactorInformationSource_1.EmissionFactorInformationSource.fromPrimitives(props.informationSource), "f");
+            __classPrivateFieldSet(this, _EmissionFactor_ipccCode, EmissionFactorIpccCode_1.EmissionFactorIpccCode.fromPrimitives(props.ipccCode), "f");
+            __classPrivateFieldSet(this, _EmissionFactor_ipccSubcategory, EmissionFactorIpccSubcategory_1.EmissionFactorIpccSubcategory.fromPrimitives(props.ipccSubcategory), "f");
+            __classPrivateFieldSet(this, _EmissionFactor_methodologicalTier, EmissionFactorMethodologicalTier_1.EmissionFactorMethodologicalTier.fromPrimitives(props.methodologicalTier), "f");
         }
     }
     static create(props) {
@@ -59,6 +71,9 @@ class EmissionFactor extends AggregateRoot_1.AggregateRoot {
             description: primitives.description,
             greenhouseGasValues: primitives.greenhouseGasValues,
             informationSource: primitives.informationSource,
+            ipccCode: primitives.ipccCode,
+            ipccSubcategory: primitives.ipccSubcategory,
+            methodologicalTier: primitives.methodologicalTier,
         };
         return new EmissionFactor(props, true);
     }
@@ -70,6 +85,9 @@ class EmissionFactor extends AggregateRoot_1.AggregateRoot {
             description: __classPrivateFieldGet(this, _EmissionFactor_description, "f").toPrimitives(),
             greenhouseGasValues: __classPrivateFieldGet(this, _EmissionFactor_greenhouseGasValues, "f").toPrimitives(),
             informationSource: __classPrivateFieldGet(this, _EmissionFactor_informationSource, "f").toPrimitives(),
+            ipccCode: __classPrivateFieldGet(this, _EmissionFactor_ipccCode, "f").toPrimitives(),
+            ipccSubcategory: __classPrivateFieldGet(this, _EmissionFactor_ipccSubcategory, "f").toPrimitives(),
+            methodologicalTier: __classPrivateFieldGet(this, _EmissionFactor_methodologicalTier, "f").toEnum(),
         };
     }
     get code() {
@@ -87,6 +105,15 @@ class EmissionFactor extends AggregateRoot_1.AggregateRoot {
     get informationSource() {
         return __classPrivateFieldGet(this, _EmissionFactor_informationSource, "f");
     }
+    get ipccCode() {
+        return __classPrivateFieldGet(this, _EmissionFactor_ipccCode, "f");
+    }
+    get ipccSubcategory() {
+        return __classPrivateFieldGet(this, _EmissionFactor_ipccSubcategory, "f");
+    }
+    get methodologicalTier() {
+        return __classPrivateFieldGet(this, _EmissionFactor_methodologicalTier, "f");
+    }
 }
 exports.EmissionFactor = EmissionFactor;
-_EmissionFactor_code = new WeakMap(), _EmissionFactor_name = new WeakMap(), _EmissionFactor_description = new WeakMap(), _EmissionFactor_greenhouseGasValues = new WeakMap(), _EmissionFactor_informationSource = new WeakMap();
+_EmissionFactor_code = new WeakMap(), _EmissionFactor_name = new WeakMap(), _EmissionFactor_description = new WeakMap(), _EmissionFactor_greenhouseGasValues = new WeakMap(), _EmissionFactor_informationSource = new WeakMap(), _EmissionFactor_ipccCode = new WeakMap(), _EmissionFactor_ipccSubcategory = new WeakMap(), _EmissionFactor_methodologicalTier = new WeakMap();

package/build/carbonbox/emission-calculation-formulas/emission-factors/domain/enums/MethodologicalTier.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MethodologicalTier = void 0;
+/**
+ * IPCC methodological tier of an emission factor
+ * Defines the level of detail and specificity of the emission factor source (IPCC 2006 Guidelines)
+ */
+var MethodologicalTier;
+(function (MethodologicalTier) {
+    /**
+     * Tier 1 - IPCC default emission factors
+     */
+    MethodologicalTier["TIER_1"] = "TIER_1";
+    /**
+     * Tier 2 - Country-specific emission factors
+     */
+    MethodologicalTier["TIER_2"] = "TIER_2";
+    /**
+     * Tier 3 - Facility or plant-specific emission factors
+     */
+    MethodologicalTier["TIER_3"] = "TIER_3";
+})(MethodologicalTier || (exports.MethodologicalTier = MethodologicalTier = {}));

package/build/carbonbox/emission-calculation-formulas/emission-factors/domain/exceptions/InvalidIpccCodeError.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidIpccCodeError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class InvalidIpccCodeError extends CodedRootError_1.CodedRootError {
+    constructor(receivedValue) {
+        const technicalMessage = `Invalid IPCC code: '${receivedValue}'. IPCC codes must follow the IPCC 2006 category format (e.g. 1A3b, 1A4a, 2B1, 4A).`;
+        const context = {
+            receivedValue,
+            receivedLength: receivedValue.length,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'Provide an IPCC 2006 category code such as 1A3b or 1A4a',
+            'Verify that the code starts with the sector number (1 to 6) followed by the category letter',
+            'Check the IPCC 2006 Guidelines for National Greenhouse Gas Inventories for the category list',
+            'Review the emission factor configuration to ensure the IPCC code is correctly assigned',
+        ];
+        super(ErrorCode_1.ErrorCode.INVALID_IPCC_CODE, technicalMessage, context, suggestions);
+        this.name = 'InvalidIpccCodeError';
+    }
+    static create(receivedValue) {
+        return new InvalidIpccCodeError(receivedValue);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.InvalidIpccCodeError = InvalidIpccCodeError;

package/build/carbonbox/emission-calculation-formulas/emission-factors/domain/exceptions/InvalidMethodologicalTierError.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidMethodologicalTierError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class InvalidMethodologicalTierError extends CodedRootError_1.CodedRootError {
+    constructor(receivedValue, validTiers) {
+        const validTiersList = validTiers.join(', ');
+        const technicalMessage = `Invalid methodological tier value '${receivedValue}': must be one of ${validTiersList}.`;
+        const context = {
+            receivedValue,
+            validTiers,
+            validTiersList,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            `Use one of the valid methodological tiers: ${validTiersList}`,
+            'Verify that the tier value is correctly spelled',
+            'Check the MethodologicalTier enum for valid options',
+            'Review the IPCC 2006 Guidelines for the tier definitions (Tier 1 default, Tier 2 country-specific, Tier 3 facility-specific)',
+        ];
+        super(ErrorCode_1.ErrorCode.INVALID_METHODOLOGICAL_TIER, technicalMessage, context, suggestions);
+        this.name = 'InvalidMethodologicalTierError';
+    }
+    static create(receivedValue, validTiers) {
+        return new InvalidMethodologicalTierError(receivedValue, validTiers);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.InvalidMethodologicalTierError = InvalidMethodologicalTierError;

package/build/carbonbox/emission-calculation-formulas/emission-factors/domain/value-objects/EmissionFactorIpccCode.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmissionFactorIpccCode = void 0;
+const String_1 = require("../../../../shared/domain/value-objects/String");
+const InvalidIpccCodeError_1 = require("../exceptions/InvalidIpccCodeError");
+class EmissionFactorIpccCode extends String_1.String {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, EmissionFactorIpccCode.PROPERTY_NAME);
+        if (skipDomainValidation === false) {
+            EmissionFactorIpccCode.guardAgainstInvalidFormat(value);
+        }
+    }
+    static create(value) {
+        String_1.String.guardAgainstEmptyValue(value, EmissionFactorIpccCode.PROPERTY_NAME);
+        String_1.String.guardAgainstInvalidType(value, EmissionFactorIpccCode.PROPERTY_NAME);
+        return new EmissionFactorIpccCode(value, false);
+    }
+    static fromPrimitives(primitive) {
+        const value = primitive;
+        return new EmissionFactorIpccCode(value, true);
+    }
+    static guardAgainstInvalidFormat(value) {
+        if (!EmissionFactorIpccCode.IPCC_CODE_REGEX.test(value)) {
+            throw InvalidIpccCodeError_1.InvalidIpccCodeError.create(value);
+        }
+    }
+    static isValidIpccCode(value) {
+        return EmissionFactorIpccCode.IPCC_CODE_REGEX.test(value);
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.EmissionFactorIpccCode = EmissionFactorIpccCode;
+EmissionFactorIpccCode.PROPERTY_NAME = 'ipccCode';
+/**
+ * IPCC 2006 category code format:
+ * sector (1-6) + optional category letter (A-H) + optional sub-category number (1-2 digits)
+ * + optional sub-sub-category letter (a-z) + optional roman numeral level.
+ * Examples: 1A, 1A3, 1A3b, 1A4a, 2B1, 4A, 1A1ai
+ */
+EmissionFactorIpccCode.IPCC_CODE_REGEX = /^[1-6](?:[A-Ha-h](?:[0-9]{1,2}(?:[a-z](?:[ivx]+)?)?)?)?$/;

package/build/carbonbox/emission-calculation-formulas/emission-factors/domain/value-objects/EmissionFactorIpccSubcategory.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmissionFactorIpccSubcategory = void 0;
+const String_1 = require("../../../../shared/domain/value-objects/String");
+class EmissionFactorIpccSubcategory extends String_1.String {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, EmissionFactorIpccSubcategory.PROPERTY_NAME);
+    }
+    static create(value) {
+        String_1.String.guardAgainstEmptyValue(value, EmissionFactorIpccSubcategory.PROPERTY_NAME);
+        String_1.String.guardAgainstInvalidType(value, EmissionFactorIpccSubcategory.PROPERTY_NAME);
+        return new EmissionFactorIpccSubcategory(value, false);
+    }
+    static fromPrimitives(primitive) {
+        const value = primitive;
+        return new EmissionFactorIpccSubcategory(value, true);
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.EmissionFactorIpccSubcategory = EmissionFactorIpccSubcategory;
+EmissionFactorIpccSubcategory.PROPERTY_NAME = 'ipccSubcategory';

package/build/carbonbox/emission-calculation-formulas/emission-factors/domain/value-objects/EmissionFactorMethodologicalTier.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmissionFactorMethodologicalTier = void 0;
+const String_1 = require("../../../../shared/domain/value-objects/String");
+const MethodologicalTier_1 = require("../enums/MethodologicalTier");
+const InvalidMethodologicalTierError_1 = require("../exceptions/InvalidMethodologicalTierError");
+class EmissionFactorMethodologicalTier extends String_1.String {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, EmissionFactorMethodologicalTier.PROPERTY_NAME);
+        if (skipDomainValidation === false) {
+            EmissionFactorMethodologicalTier.validateMethodologicalTier(value);
+        }
+    }
+    static create(value) {
+        String_1.String.guardAgainstEmptyValue(value, EmissionFactorMethodologicalTier.PROPERTY_NAME);
+        String_1.String.guardAgainstInvalidType(value, EmissionFactorMethodologicalTier.PROPERTY_NAME);
+        return new EmissionFactorMethodologicalTier(value, false);
+    }
+    static fromPrimitives(primitive) {
+        return new EmissionFactorMethodologicalTier(primitive, true);
+    }
+    /**
+     * Valida que el valor sea un tier metodológico IPCC soportado.
+     */
+    static validateMethodologicalTier(value) {
+        if (!EmissionFactorMethodologicalTier.VALID_METHODOLOGICAL_TIERS.includes(value)) {
+            throw InvalidMethodologicalTierError_1.InvalidMethodologicalTierError.create(value, EmissionFactorMethodologicalTier.VALID_METHODOLOGICAL_TIERS);
+        }
+    }
+    /**
+     * Obtiene los tiers metodológicos válidos.
+     */
+    static getValidMethodologicalTiers() {
+        return Object.freeze([...EmissionFactorMethodologicalTier.VALID_METHODOLOGICAL_TIERS]);
+    }
+    /**
+     * Verifica si un valor es un tier metodológico válido.
+     */
+    static isValidMethodologicalTier(value) {
+        return EmissionFactorMethodologicalTier.VALID_METHODOLOGICAL_TIERS.includes(value);
+    }
+    isTier1() {
+        return this.value === MethodologicalTier_1.MethodologicalTier.TIER_1;
+    }
+    isTier2() {
+        return this.value === MethodologicalTier_1.MethodologicalTier.TIER_2;
+    }
+    isTier3() {
+        return this.value === MethodologicalTier_1.MethodologicalTier.TIER_3;
+    }
+    toPrimitives() {
+        return this.value;
+    }
+    toEnum() {
+        return this.value;
+    }
+}
+exports.EmissionFactorMethodologicalTier = EmissionFactorMethodologicalTier;
+EmissionFactorMethodologicalTier.PROPERTY_NAME = 'methodologicalTier';
+EmissionFactorMethodologicalTier.VALID_METHODOLOGICAL_TIERS = Object.values(MethodologicalTier_1.MethodologicalTier);

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

@@ -207,8 +207,9 @@ class ReportInstance extends AggregateRoot_1.AggregateRoot {
         if (!__classPrivateFieldGet(this, _ReportInstance_dataSnapshot, "f") || Object.keys(__classPrivateFieldGet(this, _ReportInstance_dataSnapshot, "f")).length === 0) {
             return false;
         }
-        // Must have answered all required questionnaire questions (if any)
-        // TODO: Add validation for required questionnaire answers
+        // Required questionnaire questions are guaranteed at creation time: the application layer
+        // only creates an instance from a COMPLETED ReportPreparationQuestionnaire and freezes its
+        // self-describing answers (QuestionnaireAnswerPrimitives) into this aggregate.
         return true;
     }
     canBeApprovedInternally() {

package/build/carbonbox/reporting/report-preparation-questionnaires/domain/entity/IReportPreparationQuestionnaire.js

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

package/build/carbonbox/reporting/report-preparation-questionnaires/domain/entity/ReportPreparationQuestionnaire.js

@@ -0,0 +1,284 @@
+"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 _ReportPreparationQuestionnaire_instances, _ReportPreparationQuestionnaire_carbonClientId, _ReportPreparationQuestionnaire_reportTemplateId, _ReportPreparationQuestionnaire_reportTemplateVersion, _ReportPreparationQuestionnaire_questions, _ReportPreparationQuestionnaire_answers, _ReportPreparationQuestionnaire_status, _ReportPreparationQuestionnaire_createdAt, _ReportPreparationQuestionnaire_updatedAt, _ReportPreparationQuestionnaire_ensureCanBeModified, _ReportPreparationQuestionnaire_ensureUniqueQuestionIds, _ReportPreparationQuestionnaire_findQuestion, _ReportPreparationQuestionnaire_getQuestionOrThrow, _ReportPreparationQuestionnaire_findAnswer, _ReportPreparationQuestionnaire_getUnansweredRequiredQuestionIds, _ReportPreparationQuestionnaire_calculateCompletion;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportPreparationQuestionnaire = void 0;
+const AggregateRoot_1 = require("../../../../shared/domain/entities/AggregateRoot");
+const ReportPreparationQuestionnaireId_1 = require("../value-objects/ReportPreparationQuestionnaireId");
+const ReportPreparationQuestionnaireStatus_1 = require("../enums/ReportPreparationQuestionnaireStatus");
+const PreparationQuestion_1 = require("../value-objects/PreparationQuestion");
+const PreparationAnswer_1 = require("../value-objects/PreparationAnswer");
+const ReportPreparationQuestionnaireCompletion_1 = require("../value-objects/ReportPreparationQuestionnaireCompletion");
+const PreparationQuestionNotFoundError_1 = require("../exceptions/PreparationQuestionNotFoundError");
+const DuplicatePreparationQuestionError_1 = require("../exceptions/DuplicatePreparationQuestionError");
+const TemplateQuestionCannotBeRemovedError_1 = require("../exceptions/TemplateQuestionCannotBeRemovedError");
+const InvalidPreparationQuestionError_1 = require("../exceptions/InvalidPreparationQuestionError");
+const ReportPreparationQuestionnaireCannotBeModifiedError_1 = require("../exceptions/ReportPreparationQuestionnaireCannotBeModifiedError");
+const ReportPreparationQuestionnaireCannotBeCompletedError_1 = require("../exceptions/ReportPreparationQuestionnaireCannotBeCompletedError");
+const ReportPreparationQuestionnaireCannotBeReopenedError_1 = require("../exceptions/ReportPreparationQuestionnaireCannotBeReopenedError");
+/**
+ * Report preparation questionnaire: one per (carbonClientId, reportTemplateId).
+ *
+ * Questions come from two origins:
+ *   - TEMPLATE: materialized from the CLIENT_INPUT blocks of the report template (question id = block id).
+ *   - CUSTOM: added by the client to provide extra information the AI must use.
+ *
+ * It is a living document reused across reporting periods; each ReportInstance freezes a copy of
+ * the self-describing answers (see toQuestionnaireAnswers) at creation time.
+ */
+class ReportPreparationQuestionnaire extends AggregateRoot_1.AggregateRoot {
+    constructor(props, skipDomainValidation) {
+        const id = skipDomainValidation
+            ? ReportPreparationQuestionnaireId_1.ReportPreparationQuestionnaireId.fromPrimitives(props.id).toPrimitives()
+            : ReportPreparationQuestionnaireId_1.ReportPreparationQuestionnaireId.create(props.id).toPrimitives();
+        super({ id }, skipDomainValidation);
+        _ReportPreparationQuestionnaire_instances.add(this);
+        _ReportPreparationQuestionnaire_carbonClientId.set(this, void 0);
+        _ReportPreparationQuestionnaire_reportTemplateId.set(this, void 0);
+        _ReportPreparationQuestionnaire_reportTemplateVersion.set(this, void 0);
+        _ReportPreparationQuestionnaire_questions.set(this, void 0);
+        _ReportPreparationQuestionnaire_answers.set(this, void 0);
+        _ReportPreparationQuestionnaire_status.set(this, void 0);
+        _ReportPreparationQuestionnaire_createdAt.set(this, void 0);
+        _ReportPreparationQuestionnaire_updatedAt.set(this, void 0);
+        __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_carbonClientId, props.carbonClientId, "f");
+        __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_reportTemplateId, props.reportTemplateId, "f");
+        __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_reportTemplateVersion, props.reportTemplateVersion, "f");
+        __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_status, props.status, "f");
+        __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_createdAt, props.createdAt, "f");
+        __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_updatedAt, props.updatedAt, "f");
+        if (skipDomainValidation === false) {
+            // Initialize with domain validation
+            __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_questions, props.questions.map((question) => PreparationQuestion_1.PreparationQuestion.create(question.toPrimitives())), "f");
+            __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_answers, props.answers.map((answer) => PreparationAnswer_1.PreparationAnswer.create(answer.toPrimitives())), "f");
+            __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_instances, "m", _ReportPreparationQuestionnaire_ensureUniqueQuestionIds).call(this);
+        }
+        else {
+            // Initialize from primitives (no domain validation)
+            __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_questions, props.questions.map((question) => PreparationQuestion_1.PreparationQuestion.fromPrimitives(question.toPrimitives())), "f");
+            __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_answers, props.answers.map((answer) => PreparationAnswer_1.PreparationAnswer.fromPrimitives(answer.toPrimitives())), "f");
+        }
+    }
+    static create(props) {
+        const now = new Date().toISOString();
+        const fullProps = {
+            ...props,
+            answers: [],
+            status: ReportPreparationQuestionnaireStatus_1.ReportPreparationQuestionnaireStatus.DRAFT,
+            createdAt: now,
+            updatedAt: now,
+        };
+        return new ReportPreparationQuestionnaire(fullProps, false);
+    }
+    static fromPrimitives(primitives) {
+        const props = {
+            id: primitives.id,
+            carbonClientId: primitives.carbonClientId,
+            reportTemplateId: primitives.reportTemplateId,
+            reportTemplateVersion: primitives.reportTemplateVersion,
+            questions: primitives.questions.map((question) => PreparationQuestion_1.PreparationQuestion.fromPrimitives(question)),
+            answers: primitives.answers.map((answer) => PreparationAnswer_1.PreparationAnswer.fromPrimitives(answer)),
+            status: primitives.status,
+            createdAt: primitives.createdAt,
+            updatedAt: primitives.updatedAt,
+        };
+        return new ReportPreparationQuestionnaire(props, true);
+    }
+    get toPrimitives() {
+        return {
+            id: this.id.toPrimitives(),
+            carbonClientId: __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_carbonClientId, "f"),
+            reportTemplateId: __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_reportTemplateId, "f"),
+            reportTemplateVersion: __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_reportTemplateVersion, "f"),
+            questions: __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_questions, "f").map((question) => question.toPrimitives()),
+            answers: __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_answers, "f").map((answer) => answer.toPrimitives()),
+            status: __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_status, "f"),
+            completion: __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_instances, "m", _ReportPreparationQuestionnaire_calculateCompletion).call(this).toPrimitives(),
+            createdAt: __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_createdAt, "f"),
+            updatedAt: __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_updatedAt, "f"),
+        };
+    }
+    // Getters
+    getId() {
+        return this.id.toPrimitives();
+    }
+    getCarbonClientId() {
+        return __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_carbonClientId, "f");
+    }
+    getReportTemplateId() {
+        return __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_reportTemplateId, "f");
+    }
+    getReportTemplateVersion() {
+        return __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_reportTemplateVersion, "f");
+    }
+    getQuestions() {
+        return __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_questions, "f").map((question) => question.toPrimitives());
+    }
+    getAnswers() {
+        return __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_answers, "f").map((answer) => answer.toPrimitives());
+    }
+    getStatus() {
+        return __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_status, "f");
+    }
+    getCompletion() {
+        return __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_instances, "m", _ReportPreparationQuestionnaire_calculateCompletion).call(this).toPrimitives();
+    }
+    getCreatedAt() {
+        return __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_createdAt, "f");
+    }
+    getUpdatedAt() {
+        return __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_updatedAt, "f");
+    }
+    // Status checks
+    isDraft() {
+        return __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_status, "f") === ReportPreparationQuestionnaireStatus_1.ReportPreparationQuestionnaireStatus.DRAFT;
+    }
+    isInProgress() {
+        return __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_status, "f") === ReportPreparationQuestionnaireStatus_1.ReportPreparationQuestionnaireStatus.IN_PROGRESS;
+    }
+    isCompleted() {
+        return __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_status, "f") === ReportPreparationQuestionnaireStatus_1.ReportPreparationQuestionnaireStatus.COMPLETED;
+    }
+    // Business logic - Capabilities
+    canBeModified() {
+        return !this.isCompleted();
+    }
+    canBeCompleted() {
+        return !this.isCompleted() && __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_instances, "m", _ReportPreparationQuestionnaire_calculateCompletion).call(this).isComplete();
+    }
+    canBeReopened() {
+        return this.isCompleted();
+    }
+    // Business logic - Actions
+    addCustomQuestion(question) {
+        __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_instances, "m", _ReportPreparationQuestionnaire_ensureCanBeModified).call(this, 'add custom question');
+        if (!question.isCustom()) {
+            throw InvalidPreparationQuestionError_1.InvalidPreparationQuestionError.create(question.getId(), 'only questions with origin CUSTOM can be added to an existing questionnaire');
+        }
+        if (__classPrivateFieldGet(this, _ReportPreparationQuestionnaire_instances, "m", _ReportPreparationQuestionnaire_findQuestion).call(this, question.getId()) !== undefined) {
+            throw DuplicatePreparationQuestionError_1.DuplicatePreparationQuestionError.create(this.id.toPrimitives(), question.getId());
+        }
+        __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_questions, [...__classPrivateFieldGet(this, _ReportPreparationQuestionnaire_questions, "f"), question], "f");
+        __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_updatedAt, new Date().toISOString(), "f");
+    }
+    removeCustomQuestion(questionId) {
+        __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_instances, "m", _ReportPreparationQuestionnaire_ensureCanBeModified).call(this, 'remove custom question');
+        const question = __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_instances, "m", _ReportPreparationQuestionnaire_getQuestionOrThrow).call(this, questionId);
+        if (question.isFromTemplate()) {
+            throw TemplateQuestionCannotBeRemovedError_1.TemplateQuestionCannotBeRemovedError.create(this.id.toPrimitives(), questionId);
+        }
+        __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_questions, __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_questions, "f").filter((existing) => existing.getId() !== questionId), "f");
+        __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_answers, __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_answers, "f").filter((existing) => existing.getQuestionId() !== questionId), "f");
+        __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_updatedAt, new Date().toISOString(), "f");
+    }
+    answerQuestion(questionId, answer, answeredBy) {
+        __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_instances, "m", _ReportPreparationQuestionnaire_ensureCanBeModified).call(this, 'answer question');
+        const question = __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_instances, "m", _ReportPreparationQuestionnaire_getQuestionOrThrow).call(this, questionId);
+        question.validateAnswer(answer);
+        const newAnswer = PreparationAnswer_1.PreparationAnswer.create({
+            questionId,
+            answer: answer.trim(),
+            answeredAt: new Date().toISOString(),
+            answeredBy,
+        });
+        __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_answers, [
+            ...__classPrivateFieldGet(this, _ReportPreparationQuestionnaire_answers, "f").filter((existing) => existing.getQuestionId() !== questionId),
+            newAnswer,
+        ], "f");
+        __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_status, ReportPreparationQuestionnaireStatus_1.ReportPreparationQuestionnaireStatus.IN_PROGRESS, "f");
+        __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_updatedAt, new Date().toISOString(), "f");
+    }
+    complete() {
+        if (!this.canBeCompleted()) {
+            throw ReportPreparationQuestionnaireCannotBeCompletedError_1.ReportPreparationQuestionnaireCannotBeCompletedError.create(this.id.toPrimitives(), __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_status, "f"), __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_instances, "m", _ReportPreparationQuestionnaire_calculateCompletion).call(this).toPrimitives(), __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_instances, "m", _ReportPreparationQuestionnaire_getUnansweredRequiredQuestionIds).call(this));
+        }
+        __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_status, ReportPreparationQuestionnaireStatus_1.ReportPreparationQuestionnaireStatus.COMPLETED, "f");
+        __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_updatedAt, new Date().toISOString(), "f");
+    }
+    reopen() {
+        if (!this.canBeReopened()) {
+            throw ReportPreparationQuestionnaireCannotBeReopenedError_1.ReportPreparationQuestionnaireCannotBeReopenedError.create(this.id.toPrimitives(), __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_status, "f"));
+        }
+        __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_status, ReportPreparationQuestionnaireStatus_1.ReportPreparationQuestionnaireStatus.IN_PROGRESS, "f");
+        __classPrivateFieldSet(this, _ReportPreparationQuestionnaire_updatedAt, new Date().toISOString(), "f");
+    }
+    /**
+     * Self-describing projection of the answers, frozen into a ReportInstance and consumed by the AI.
+     * Ordered by question order so the prompt follows the template structure.
+     */
+    toQuestionnaireAnswers() {
+        return [...__classPrivateFieldGet(this, _ReportPreparationQuestionnaire_questions, "f")]
+            .sort((first, second) => first.getOrder() - second.getOrder())
+            .flatMap((question) => {
+            const answer = __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_instances, "m", _ReportPreparationQuestionnaire_findAnswer).call(this, question.getId());
+            if (answer === undefined) {
+                return [];
+            }
+            return [{
+                    questionId: question.getId(),
+                    origin: question.getOrigin(),
+                    questionText: question.getQuestionText(),
+                    targetSectionId: question.getTargetSectionId(),
+                    aiInstruction: question.getAiInstruction(),
+                    answer: answer.getAnswer(),
+                    answeredAt: answer.getAnsweredAt(),
+                    answeredBy: answer.getAnsweredBy(),
+                }];
+        });
+    }
+    // Helper methods
+    getUnansweredRequiredQuestionIds() {
+        return __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_instances, "m", _ReportPreparationQuestionnaire_getUnansweredRequiredQuestionIds).call(this);
+    }
+    hasAnswerFor(questionId) {
+        return __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_instances, "m", _ReportPreparationQuestionnaire_findAnswer).call(this, questionId) !== undefined;
+    }
+}
+exports.ReportPreparationQuestionnaire = ReportPreparationQuestionnaire;
+_ReportPreparationQuestionnaire_carbonClientId = new WeakMap(), _ReportPreparationQuestionnaire_reportTemplateId = new WeakMap(), _ReportPreparationQuestionnaire_reportTemplateVersion = new WeakMap(), _ReportPreparationQuestionnaire_questions = new WeakMap(), _ReportPreparationQuestionnaire_answers = new WeakMap(), _ReportPreparationQuestionnaire_status = new WeakMap(), _ReportPreparationQuestionnaire_createdAt = new WeakMap(), _ReportPreparationQuestionnaire_updatedAt = new WeakMap(), _ReportPreparationQuestionnaire_instances = new WeakSet(), _ReportPreparationQuestionnaire_ensureCanBeModified = function _ReportPreparationQuestionnaire_ensureCanBeModified(attemptedAction) {
+    if (!this.canBeModified()) {
+        throw ReportPreparationQuestionnaireCannotBeModifiedError_1.ReportPreparationQuestionnaireCannotBeModifiedError.create(this.id.toPrimitives(), __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_status, "f"), attemptedAction);
+    }
+}, _ReportPreparationQuestionnaire_ensureUniqueQuestionIds = function _ReportPreparationQuestionnaire_ensureUniqueQuestionIds() {
+    const seenQuestionIds = new Set();
+    __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_questions, "f").forEach((question) => {
+        if (seenQuestionIds.has(question.getId())) {
+            throw DuplicatePreparationQuestionError_1.DuplicatePreparationQuestionError.create(this.id.toPrimitives(), question.getId());
+        }
+        seenQuestionIds.add(question.getId());
+    });
+}, _ReportPreparationQuestionnaire_findQuestion = function _ReportPreparationQuestionnaire_findQuestion(questionId) {
+    return __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_questions, "f").find((question) => question.getId() === questionId);
+}, _ReportPreparationQuestionnaire_getQuestionOrThrow = function _ReportPreparationQuestionnaire_getQuestionOrThrow(questionId) {
+    const question = __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_instances, "m", _ReportPreparationQuestionnaire_findQuestion).call(this, questionId);
+    if (question === undefined) {
+        throw PreparationQuestionNotFoundError_1.PreparationQuestionNotFoundError.create(this.id.toPrimitives(), questionId);
+    }
+    return question;
+}, _ReportPreparationQuestionnaire_findAnswer = function _ReportPreparationQuestionnaire_findAnswer(questionId) {
+    return __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_answers, "f").find((answer) => answer.getQuestionId() === questionId);
+}, _ReportPreparationQuestionnaire_getUnansweredRequiredQuestionIds = function _ReportPreparationQuestionnaire_getUnansweredRequiredQuestionIds() {
+    return __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_questions, "f")
+        .filter((question) => question.isRequired() && __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_instances, "m", _ReportPreparationQuestionnaire_findAnswer).call(this, question.getId()) === undefined)
+        .map((question) => question.getId());
+}, _ReportPreparationQuestionnaire_calculateCompletion = function _ReportPreparationQuestionnaire_calculateCompletion() {
+    const requiredQuestions = __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_questions, "f").filter((question) => question.isRequired());
+    const answeredRequired = requiredQuestions.filter((question) => __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_instances, "m", _ReportPreparationQuestionnaire_findAnswer).call(this, question.getId()) !== undefined);
+    const answeredTotal = __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_questions, "f").filter((question) => __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_instances, "m", _ReportPreparationQuestionnaire_findAnswer).call(this, question.getId()) !== undefined);
+    return ReportPreparationQuestionnaireCompletion_1.ReportPreparationQuestionnaireCompletion.create({
+        answeredRequired: answeredRequired.length,
+        totalRequired: requiredQuestions.length,
+        answeredTotal: answeredTotal.length,
+        totalQuestions: __classPrivateFieldGet(this, _ReportPreparationQuestionnaire_questions, "f").length,
+    });
+};

package/build/carbonbox/reporting/report-preparation-questionnaires/domain/enums/ReportPreparationQuestionnaireStatus.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportPreparationQuestionnaireStatus = void 0;
+/**
+ * Report preparation questionnaire status enumeration
+ * Defines the lifecycle states of a client questionnaire for a report template
+ */
+var ReportPreparationQuestionnaireStatus;
+(function (ReportPreparationQuestionnaireStatus) {
+    /**
+     * Draft - Questionnaire created, no answers yet
+     */
+    ReportPreparationQuestionnaireStatus["DRAFT"] = "DRAFT";
+    /**
+     * In progress - At least one answer provided (or reopened after completion)
+     */
+    ReportPreparationQuestionnaireStatus["IN_PROGRESS"] = "IN_PROGRESS";
+    /**
+     * Completed - All required questions answered; report instances can be created from it
+     */
+    ReportPreparationQuestionnaireStatus["COMPLETED"] = "COMPLETED";
+})(ReportPreparationQuestionnaireStatus || (exports.ReportPreparationQuestionnaireStatus = ReportPreparationQuestionnaireStatus = {}));