@carbonbox/domain 0.37.0 → 0.38.0

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 = {}));

package/build/carbonbox/reporting/report-preparation-questionnaires/domain/exceptions/DuplicatePreparationQuestionError.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DuplicatePreparationQuestionError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class DuplicatePreparationQuestionError extends CodedRootError_1.CodedRootError {
+    constructor(questionnaireId, questionId) {
+        const technicalMessage = `Preparation question '${questionId}' already exists in report preparation questionnaire '${questionnaireId}'.`;
+        const context = {
+            questionnaireId,
+            questionId,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'Question ids must be unique within a questionnaire',
+            'Generate a new semantic id (RPT-PRE-QST) for each custom question',
+            'Template questions are materialized once from the template blocks; do not add them again',
+        ];
+        super(ErrorCode_1.ErrorCode.DUPLICATE_PREPARATION_QUESTION, technicalMessage, context, suggestions);
+        this.name = 'DuplicatePreparationQuestionError';
+    }
+    static create(questionnaireId, questionId) {
+        return new DuplicatePreparationQuestionError(questionnaireId, questionId);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.DuplicatePreparationQuestionError = DuplicatePreparationQuestionError;

package/build/carbonbox/reporting/report-preparation-questionnaires/domain/exceptions/InvalidPreparationAnswerError.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidPreparationAnswerError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class InvalidPreparationAnswerError extends CodedRootError_1.CodedRootError {
+    constructor(questionId, fieldType, receivedAnswer, reason) {
+        const technicalMessage = `Invalid answer for preparation question '${questionId}' (${fieldType}): ${reason}`;
+        const context = {
+            questionId,
+            fieldType,
+            receivedAnswer,
+            receivedLength: receivedAnswer.length,
+            reason,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'Provide an answer compatible with the question field type',
+            'For SINGLE_CHOICE use one of the configured options; for MULTIPLE_CHOICE send a JSON array of options',
+            'For NUMBER send a numeric value; for DATE send an ISO 8601 date',
+            'Respect the minLength / maxLength configured for text questions',
+        ];
+        super(ErrorCode_1.ErrorCode.INVALID_PREPARATION_ANSWER, technicalMessage, context, suggestions);
+        this.name = 'InvalidPreparationAnswerError';
+    }
+    static create(questionId, fieldType, receivedAnswer, reason) {
+        return new InvalidPreparationAnswerError(questionId, fieldType, receivedAnswer, reason);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.InvalidPreparationAnswerError = InvalidPreparationAnswerError;

package/build/carbonbox/reporting/report-preparation-questionnaires/domain/exceptions/InvalidPreparationQuestionError.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidPreparationQuestionError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class InvalidPreparationQuestionError extends CodedRootError_1.CodedRootError {
+    constructor(questionId, reason) {
+        const technicalMessage = `Invalid preparation question '${questionId}': ${reason}`;
+        const context = {
+            questionId,
+            reason,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'Provide a non-empty id and questionText',
+            'SINGLE_CHOICE and MULTIPLE_CHOICE questions need at least one option; other field types must not define options',
+            'minLength / maxLength must be non-negative and minLength cannot exceed maxLength',
+            'order must be a non-negative integer',
+        ];
+        super(ErrorCode_1.ErrorCode.INVALID_PREPARATION_QUESTION, technicalMessage, context, suggestions);
+        this.name = 'InvalidPreparationQuestionError';
+    }
+    static create(questionId, reason) {
+        return new InvalidPreparationQuestionError(questionId, reason);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.InvalidPreparationQuestionError = InvalidPreparationQuestionError;

package/build/carbonbox/reporting/report-preparation-questionnaires/domain/exceptions/PreparationQuestionNotFoundError.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreparationQuestionNotFoundError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class PreparationQuestionNotFoundError extends CodedRootError_1.CodedRootError {
+    constructor(questionnaireId, questionId) {
+        const technicalMessage = `Preparation question '${questionId}' does not exist in report preparation questionnaire '${questionnaireId}'.`;
+        const context = {
+            questionnaireId,
+            questionId,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'Verify the question id belongs to this questionnaire (template block id or custom question id)',
+            'Retrieve the questionnaire to list its current questions',
+            'Custom questions may have been removed; refresh the questionnaire before answering',
+        ];
+        super(ErrorCode_1.ErrorCode.PREPARATION_QUESTION_NOT_FOUND, technicalMessage, context, suggestions);
+        this.name = 'PreparationQuestionNotFoundError';
+    }
+    static create(questionnaireId, questionId) {
+        return new PreparationQuestionNotFoundError(questionnaireId, questionId);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.PreparationQuestionNotFoundError = PreparationQuestionNotFoundError;

package/build/carbonbox/reporting/report-preparation-questionnaires/domain/exceptions/ReportPreparationQuestionnaireCannotBeCompletedError.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportPreparationQuestionnaireCannotBeCompletedError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class ReportPreparationQuestionnaireCannotBeCompletedError extends CodedRootError_1.CodedRootError {
+    constructor(questionnaireId, currentStatus, completion, unansweredRequiredQuestionIds) {
+        const technicalMessage = `Report preparation questionnaire '${questionnaireId}' cannot be completed. Current status: ${currentStatus}. Required questions answered: ${completion.answeredRequired}/${completion.totalRequired}. Missing: ${unansweredRequiredQuestionIds.join(', ') || 'none'}.`;
+        const context = {
+            questionnaireId,
+            currentStatus,
+            completion,
+            unansweredRequiredQuestionIds,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'Answer every required question before completing the questionnaire',
+            'Retrieve the questionnaire to see which required questions are still unanswered',
+            'A questionnaire that is already COMPLETED does not need to be completed again',
+        ];
+        super(ErrorCode_1.ErrorCode.REPORT_PREPARATION_QUESTIONNAIRE_CANNOT_BE_COMPLETED, technicalMessage, context, suggestions);
+        this.name = 'ReportPreparationQuestionnaireCannotBeCompletedError';
+    }
+    static create(questionnaireId, currentStatus, completion, unansweredRequiredQuestionIds) {
+        return new ReportPreparationQuestionnaireCannotBeCompletedError(questionnaireId, currentStatus, completion, unansweredRequiredQuestionIds);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.ReportPreparationQuestionnaireCannotBeCompletedError = ReportPreparationQuestionnaireCannotBeCompletedError;

package/build/carbonbox/reporting/report-preparation-questionnaires/domain/exceptions/ReportPreparationQuestionnaireCannotBeModifiedError.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportPreparationQuestionnaireCannotBeModifiedError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class ReportPreparationQuestionnaireCannotBeModifiedError extends CodedRootError_1.CodedRootError {
+    constructor(questionnaireId, currentStatus, attemptedAction) {
+        const technicalMessage = `Report preparation questionnaire '${questionnaireId}' cannot be modified (${attemptedAction}). Current status: ${currentStatus}.`;
+        const context = {
+            questionnaireId,
+            currentStatus,
+            attemptedAction,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'Completed questionnaires are frozen; reopen the questionnaire before answering or changing custom questions',
+            `Review the current status of questionnaire '${questionnaireId}'`,
+        ];
+        super(ErrorCode_1.ErrorCode.REPORT_PREPARATION_QUESTIONNAIRE_CANNOT_BE_MODIFIED, technicalMessage, context, suggestions);
+        this.name = 'ReportPreparationQuestionnaireCannotBeModifiedError';
+    }
+    static create(questionnaireId, currentStatus, attemptedAction) {
+        return new ReportPreparationQuestionnaireCannotBeModifiedError(questionnaireId, currentStatus, attemptedAction);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.ReportPreparationQuestionnaireCannotBeModifiedError = ReportPreparationQuestionnaireCannotBeModifiedError;

package/build/carbonbox/reporting/report-preparation-questionnaires/domain/exceptions/ReportPreparationQuestionnaireCannotBeReopenedError.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportPreparationQuestionnaireCannotBeReopenedError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class ReportPreparationQuestionnaireCannotBeReopenedError extends CodedRootError_1.CodedRootError {
+    constructor(questionnaireId, currentStatus) {
+        const technicalMessage = `Report preparation questionnaire '${questionnaireId}' cannot be reopened. Current status: ${currentStatus}. Only COMPLETED questionnaires can be reopened.`;
+        const context = {
+            questionnaireId,
+            currentStatus,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'Only COMPLETED questionnaires can be reopened',
+            'DRAFT and IN_PROGRESS questionnaires are already editable',
+        ];
+        super(ErrorCode_1.ErrorCode.REPORT_PREPARATION_QUESTIONNAIRE_CANNOT_BE_REOPENED, technicalMessage, context, suggestions);
+        this.name = 'ReportPreparationQuestionnaireCannotBeReopenedError';
+    }
+    static create(questionnaireId, currentStatus) {
+        return new ReportPreparationQuestionnaireCannotBeReopenedError(questionnaireId, currentStatus);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.ReportPreparationQuestionnaireCannotBeReopenedError = ReportPreparationQuestionnaireCannotBeReopenedError;

package/build/carbonbox/reporting/report-preparation-questionnaires/domain/exceptions/TemplateQuestionCannotBeRemovedError.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplateQuestionCannotBeRemovedError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class TemplateQuestionCannotBeRemovedError extends CodedRootError_1.CodedRootError {
+    constructor(questionnaireId, questionId) {
+        const technicalMessage = `Preparation question '${questionId}' in questionnaire '${questionnaireId}' comes from the report template and cannot be removed. Only CUSTOM questions can be removed.`;
+        const context = {
+            questionnaireId,
+            questionId,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'Only questions with origin CUSTOM can be removed from a questionnaire',
+            'Template questions are defined by the CLIENT_INPUT blocks of the report template; change the template instead',
+            'If the question is not applicable and it is not required, leave it unanswered',
+        ];
+        super(ErrorCode_1.ErrorCode.TEMPLATE_QUESTION_CANNOT_BE_REMOVED, technicalMessage, context, suggestions);
+        this.name = 'TemplateQuestionCannotBeRemovedError';
+    }
+    static create(questionnaireId, questionId) {
+        return new TemplateQuestionCannotBeRemovedError(questionnaireId, questionId);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.TemplateQuestionCannotBeRemovedError = TemplateQuestionCannotBeRemovedError;

package/build/carbonbox/reporting/report-preparation-questionnaires/domain/repository/IReportPreparationQuestionnaireRepository.js

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

package/build/carbonbox/reporting/report-preparation-questionnaires/domain/types/PreparationAnswerPrimitives.js

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

package/build/carbonbox/reporting/report-preparation-questionnaires/domain/types/PreparationQuestionPrimitives.js

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

package/build/carbonbox/reporting/report-preparation-questionnaires/domain/types/ReportPreparationQuestionnaireCompletionPrimitives.js

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

package/build/carbonbox/reporting/report-preparation-questionnaires/domain/types/ReportPreparationQuestionnairePrimitives.js

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

package/build/carbonbox/reporting/report-preparation-questionnaires/domain/types/ReportPreparationQuestionnaireProps.js

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