@carbonbox/domain 0.30.5 → 0.32.0

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

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

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

@@ -0,0 +1,371 @@
+"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 _ReportInstance_templateId, _ReportInstance_templateVersion, _ReportInstance_carbonClientId, _ReportInstance_period, _ReportInstance_filters, _ReportInstance_questionnaireAnswers, _ReportInstance_dataSnapshot, _ReportInstance_generatedContent, _ReportInstance_pdfUrl, _ReportInstance_status, _ReportInstance_approvals, _ReportInstance_aiExecutions, _ReportInstance_createdAt, _ReportInstance_updatedAt;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportInstance = void 0;
+const AggregateRoot_1 = require("../../../../shared/domain/entities/AggregateRoot");
+const ReportInstanceId_1 = require("../value-objects/ReportInstanceId");
+const ReportInstanceStatus_1 = require("../enums/ReportInstanceStatus");
+const ReportInstanceCannotBeGeneratedError_1 = require("../exceptions/ReportInstanceCannotBeGeneratedError");
+const ReportInstanceCannotBeApprovedInternallyError_1 = require("../exceptions/ReportInstanceCannotBeApprovedInternallyError");
+const ReportInstanceCannotBeApprovedByClientError_1 = require("../exceptions/ReportInstanceCannotBeApprovedByClientError");
+const ReportInstanceCannotBePublishedError_1 = require("../exceptions/ReportInstanceCannotBePublishedError");
+const ReportInstanceCannotBeRejectedError_1 = require("../exceptions/ReportInstanceCannotBeRejectedError");
+const ReportInstanceInvalidStatusTransitionError_1 = require("../exceptions/ReportInstanceInvalidStatusTransitionError");
+class ReportInstance extends AggregateRoot_1.AggregateRoot {
+    constructor(props, skipDomainValidation) {
+        const id = skipDomainValidation
+            ? ReportInstanceId_1.ReportInstanceId.fromPrimitives(props.id).toPrimitives()
+            : ReportInstanceId_1.ReportInstanceId.create(props.id).toPrimitives();
+        super({ id }, skipDomainValidation);
+        _ReportInstance_templateId.set(this, void 0);
+        _ReportInstance_templateVersion.set(this, void 0);
+        _ReportInstance_carbonClientId.set(this, void 0);
+        _ReportInstance_period.set(this, void 0);
+        _ReportInstance_filters.set(this, void 0);
+        _ReportInstance_questionnaireAnswers.set(this, void 0);
+        _ReportInstance_dataSnapshot.set(this, void 0);
+        _ReportInstance_generatedContent.set(this, void 0);
+        _ReportInstance_pdfUrl.set(this, void 0);
+        _ReportInstance_status.set(this, void 0);
+        _ReportInstance_approvals.set(this, void 0);
+        _ReportInstance_aiExecutions.set(this, void 0);
+        _ReportInstance_createdAt.set(this, void 0);
+        _ReportInstance_updatedAt.set(this, void 0);
+        __classPrivateFieldSet(this, _ReportInstance_templateId, props.templateId, "f");
+        __classPrivateFieldSet(this, _ReportInstance_templateVersion, props.templateVersion, "f");
+        __classPrivateFieldSet(this, _ReportInstance_carbonClientId, props.carbonClientId, "f");
+        __classPrivateFieldSet(this, _ReportInstance_period, props.period, "f");
+        __classPrivateFieldSet(this, _ReportInstance_filters, props.filters, "f");
+        __classPrivateFieldSet(this, _ReportInstance_questionnaireAnswers, props.questionnaireAnswers, "f");
+        __classPrivateFieldSet(this, _ReportInstance_dataSnapshot, props.dataSnapshot, "f");
+        __classPrivateFieldSet(this, _ReportInstance_generatedContent, props.generatedContent, "f");
+        __classPrivateFieldSet(this, _ReportInstance_pdfUrl, props.pdfUrl, "f");
+        __classPrivateFieldSet(this, _ReportInstance_status, props.status, "f");
+        __classPrivateFieldSet(this, _ReportInstance_approvals, props.approvals, "f");
+        __classPrivateFieldSet(this, _ReportInstance_aiExecutions, props.aiExecutions, "f");
+        __classPrivateFieldSet(this, _ReportInstance_createdAt, props.createdAt, "f");
+        __classPrivateFieldSet(this, _ReportInstance_updatedAt, props.updatedAt, "f");
+    }
+    static create(props) {
+        const now = new Date().toISOString();
+        const id = `${props.carbonClientId}-${props.templateId}-${now}`;
+        const fullProps = {
+            ...props,
+            id,
+            generatedContent: null,
+            pdfUrl: null,
+            status: ReportInstanceStatus_1.ReportInstanceStatus.DRAFT,
+            approvals: [],
+            aiExecutions: [],
+            createdAt: now,
+            updatedAt: now,
+        };
+        return new ReportInstance(fullProps, false);
+    }
+    static fromPrimitives(primitives) {
+        const props = {
+            id: primitives.id,
+            templateId: primitives.templateId,
+            templateVersion: primitives.templateVersion,
+            carbonClientId: primitives.carbonClientId,
+            period: primitives.period,
+            filters: primitives.filters,
+            questionnaireAnswers: primitives.questionnaireAnswers,
+            dataSnapshot: primitives.dataSnapshot,
+            generatedContent: primitives.generatedContent,
+            pdfUrl: primitives.pdfUrl,
+            status: primitives.status,
+            approvals: primitives.approvals,
+            aiExecutions: primitives.aiExecutions,
+            createdAt: primitives.createdAt,
+            updatedAt: primitives.updatedAt,
+        };
+        return new ReportInstance(props, true);
+    }
+    get toPrimitives() {
+        return {
+            id: this.id.toPrimitives(),
+            templateId: __classPrivateFieldGet(this, _ReportInstance_templateId, "f"),
+            templateVersion: __classPrivateFieldGet(this, _ReportInstance_templateVersion, "f"),
+            carbonClientId: __classPrivateFieldGet(this, _ReportInstance_carbonClientId, "f"),
+            period: __classPrivateFieldGet(this, _ReportInstance_period, "f"),
+            filters: __classPrivateFieldGet(this, _ReportInstance_filters, "f"),
+            questionnaireAnswers: __classPrivateFieldGet(this, _ReportInstance_questionnaireAnswers, "f"),
+            dataSnapshot: __classPrivateFieldGet(this, _ReportInstance_dataSnapshot, "f"),
+            generatedContent: __classPrivateFieldGet(this, _ReportInstance_generatedContent, "f"),
+            pdfUrl: __classPrivateFieldGet(this, _ReportInstance_pdfUrl, "f"),
+            status: __classPrivateFieldGet(this, _ReportInstance_status, "f"),
+            approvals: __classPrivateFieldGet(this, _ReportInstance_approvals, "f"),
+            aiExecutions: __classPrivateFieldGet(this, _ReportInstance_aiExecutions, "f"),
+            createdAt: __classPrivateFieldGet(this, _ReportInstance_createdAt, "f"),
+            updatedAt: __classPrivateFieldGet(this, _ReportInstance_updatedAt, "f"),
+        };
+    }
+    toProps() {
+        return {
+            id: this.id.toPrimitives(),
+            templateId: __classPrivateFieldGet(this, _ReportInstance_templateId, "f"),
+            templateVersion: __classPrivateFieldGet(this, _ReportInstance_templateVersion, "f"),
+            carbonClientId: __classPrivateFieldGet(this, _ReportInstance_carbonClientId, "f"),
+            period: __classPrivateFieldGet(this, _ReportInstance_period, "f"),
+            filters: __classPrivateFieldGet(this, _ReportInstance_filters, "f"),
+            questionnaireAnswers: __classPrivateFieldGet(this, _ReportInstance_questionnaireAnswers, "f"),
+            dataSnapshot: __classPrivateFieldGet(this, _ReportInstance_dataSnapshot, "f"),
+            generatedContent: __classPrivateFieldGet(this, _ReportInstance_generatedContent, "f"),
+            pdfUrl: __classPrivateFieldGet(this, _ReportInstance_pdfUrl, "f"),
+            status: __classPrivateFieldGet(this, _ReportInstance_status, "f"),
+            approvals: __classPrivateFieldGet(this, _ReportInstance_approvals, "f"),
+            aiExecutions: __classPrivateFieldGet(this, _ReportInstance_aiExecutions, "f"),
+            createdAt: __classPrivateFieldGet(this, _ReportInstance_createdAt, "f"),
+            updatedAt: __classPrivateFieldGet(this, _ReportInstance_updatedAt, "f"),
+        };
+    }
+    // Getters
+    getId() {
+        return this.id.toPrimitives();
+    }
+    getTemplateId() {
+        return __classPrivateFieldGet(this, _ReportInstance_templateId, "f");
+    }
+    getTemplateVersion() {
+        return __classPrivateFieldGet(this, _ReportInstance_templateVersion, "f");
+    }
+    getCarbonClientId() {
+        return __classPrivateFieldGet(this, _ReportInstance_carbonClientId, "f");
+    }
+    getPeriod() {
+        return __classPrivateFieldGet(this, _ReportInstance_period, "f");
+    }
+    getFilters() {
+        return __classPrivateFieldGet(this, _ReportInstance_filters, "f");
+    }
+    getQuestionnaireAnswers() {
+        return [...__classPrivateFieldGet(this, _ReportInstance_questionnaireAnswers, "f")];
+    }
+    getDataSnapshot() {
+        return __classPrivateFieldGet(this, _ReportInstance_dataSnapshot, "f");
+    }
+    getGeneratedContent() {
+        return __classPrivateFieldGet(this, _ReportInstance_generatedContent, "f");
+    }
+    getPdfUrl() {
+        return __classPrivateFieldGet(this, _ReportInstance_pdfUrl, "f");
+    }
+    getStatus() {
+        return __classPrivateFieldGet(this, _ReportInstance_status, "f");
+    }
+    getApprovals() {
+        return [...__classPrivateFieldGet(this, _ReportInstance_approvals, "f")];
+    }
+    getAiExecutions() {
+        return [...__classPrivateFieldGet(this, _ReportInstance_aiExecutions, "f")];
+    }
+    getCreatedAt() {
+        return __classPrivateFieldGet(this, _ReportInstance_createdAt, "f");
+    }
+    getUpdatedAt() {
+        return __classPrivateFieldGet(this, _ReportInstance_updatedAt, "f");
+    }
+    // Status checks
+    isDraft() {
+        return __classPrivateFieldGet(this, _ReportInstance_status, "f") === ReportInstanceStatus_1.ReportInstanceStatus.DRAFT;
+    }
+    isGenerating() {
+        return __classPrivateFieldGet(this, _ReportInstance_status, "f") === ReportInstanceStatus_1.ReportInstanceStatus.GENERATING;
+    }
+    isPendingInternal() {
+        return __classPrivateFieldGet(this, _ReportInstance_status, "f") === ReportInstanceStatus_1.ReportInstanceStatus.PENDING_INTERNAL;
+    }
+    isPendingClient() {
+        return __classPrivateFieldGet(this, _ReportInstance_status, "f") === ReportInstanceStatus_1.ReportInstanceStatus.PENDING_CLIENT;
+    }
+    isApproved() {
+        return __classPrivateFieldGet(this, _ReportInstance_status, "f") === ReportInstanceStatus_1.ReportInstanceStatus.APPROVED;
+    }
+    isPublished() {
+        return __classPrivateFieldGet(this, _ReportInstance_status, "f") === ReportInstanceStatus_1.ReportInstanceStatus.PUBLISHED;
+    }
+    isRejected() {
+        return __classPrivateFieldGet(this, _ReportInstance_status, "f") === ReportInstanceStatus_1.ReportInstanceStatus.REJECTED;
+    }
+    // Business logic - Capabilities
+    canBeGenerated() {
+        // Can only generate from DRAFT or REJECTED status
+        if (!this.isDraft() && !this.isRejected()) {
+            return false;
+        }
+        // Must have data snapshot
+        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
+        return true;
+    }
+    canBeApprovedInternally() {
+        // Can only approve internally if status is PENDING_INTERNAL
+        if (!this.isPendingInternal()) {
+            return false;
+        }
+        // Must have generated content
+        if (!this.hasGeneratedContent()) {
+            return false;
+        }
+        return true;
+    }
+    canBeApprovedByClient() {
+        // Can only approve by client if status is PENDING_CLIENT
+        if (!this.isPendingClient()) {
+            return false;
+        }
+        // Must have generated content
+        if (!this.hasGeneratedContent()) {
+            return false;
+        }
+        return true;
+    }
+    canBePublished() {
+        // Can only publish if APPROVED
+        if (!this.isApproved()) {
+            return false;
+        }
+        // Must have generated content
+        if (!this.hasGeneratedContent()) {
+            return false;
+        }
+        return true;
+    }
+    canBeRejected() {
+        // Can reject if PENDING_INTERNAL or PENDING_CLIENT
+        return this.isPendingInternal() || this.isPendingClient();
+    }
+    // Business logic - Actions
+    startGeneration() {
+        if (!this.canBeGenerated()) {
+            const reason = this.isDraft() || this.isRejected()
+                ? 'Data snapshot is missing or empty'
+                : `Invalid status for generation: ${__classPrivateFieldGet(this, _ReportInstance_status, "f")}`;
+            throw ReportInstanceCannotBeGeneratedError_1.ReportInstanceCannotBeGeneratedError.create(this.id.toPrimitives(), __classPrivateFieldGet(this, _ReportInstance_status, "f"), reason);
+        }
+        __classPrivateFieldSet(this, _ReportInstance_status, ReportInstanceStatus_1.ReportInstanceStatus.GENERATING, "f");
+        __classPrivateFieldSet(this, _ReportInstance_updatedAt, new Date().toISOString(), "f");
+    }
+    completeGeneration(generatedContent) {
+        if (!this.isGenerating()) {
+            throw ReportInstanceInvalidStatusTransitionError_1.ReportInstanceInvalidStatusTransitionError.create(this.id.toPrimitives(), __classPrivateFieldGet(this, _ReportInstance_status, "f"), ReportInstanceStatus_1.ReportInstanceStatus.PENDING_INTERNAL);
+        }
+        __classPrivateFieldSet(this, _ReportInstance_generatedContent, generatedContent, "f");
+        __classPrivateFieldSet(this, _ReportInstance_status, ReportInstanceStatus_1.ReportInstanceStatus.PENDING_INTERNAL, "f");
+        __classPrivateFieldSet(this, _ReportInstance_updatedAt, new Date().toISOString(), "f");
+    }
+    approveInternally(approverUserId, comments) {
+        if (!this.canBeApprovedInternally()) {
+            const reason = !this.isPendingInternal()
+                ? `Invalid status: ${__classPrivateFieldGet(this, _ReportInstance_status, "f")}`
+                : 'Missing generated content';
+            throw ReportInstanceCannotBeApprovedInternallyError_1.ReportInstanceCannotBeApprovedInternallyError.create(this.id.toPrimitives(), __classPrivateFieldGet(this, _ReportInstance_status, "f"), reason);
+        }
+        const approval = {
+            approvedBy: approverUserId,
+            role: 'INTERNAL',
+            approvedAt: new Date().toISOString(),
+            comments: comments || null,
+            decision: 'APPROVED',
+        };
+        __classPrivateFieldGet(this, _ReportInstance_approvals, "f").push(approval);
+        // Move to client approval or approved
+        __classPrivateFieldSet(this, _ReportInstance_status, this.requiresClientApproval()
+            ? ReportInstanceStatus_1.ReportInstanceStatus.PENDING_CLIENT
+            : ReportInstanceStatus_1.ReportInstanceStatus.APPROVED, "f");
+        __classPrivateFieldSet(this, _ReportInstance_updatedAt, new Date().toISOString(), "f");
+    }
+    approveByClient(approverUserId, comments) {
+        if (!this.canBeApprovedByClient()) {
+            const reason = !this.isPendingClient()
+                ? `Invalid status: ${__classPrivateFieldGet(this, _ReportInstance_status, "f")}`
+                : 'Missing generated content';
+            throw ReportInstanceCannotBeApprovedByClientError_1.ReportInstanceCannotBeApprovedByClientError.create(this.id.toPrimitives(), __classPrivateFieldGet(this, _ReportInstance_status, "f"), reason);
+        }
+        const approval = {
+            approvedBy: approverUserId,
+            role: 'CLIENT',
+            approvedAt: new Date().toISOString(),
+            comments: comments || null,
+            decision: 'APPROVED',
+        };
+        __classPrivateFieldGet(this, _ReportInstance_approvals, "f").push(approval);
+        __classPrivateFieldSet(this, _ReportInstance_status, ReportInstanceStatus_1.ReportInstanceStatus.APPROVED, "f");
+        __classPrivateFieldSet(this, _ReportInstance_updatedAt, new Date().toISOString(), "f");
+    }
+    reject(rejectorUserId, reason) {
+        if (!this.canBeRejected()) {
+            throw ReportInstanceCannotBeRejectedError_1.ReportInstanceCannotBeRejectedError.create(this.id.toPrimitives(), __classPrivateFieldGet(this, _ReportInstance_status, "f"), `Invalid status for rejection: ${__classPrivateFieldGet(this, _ReportInstance_status, "f")}`);
+        }
+        const approval = {
+            approvedBy: rejectorUserId,
+            role: this.isPendingClient() ? 'CLIENT' : 'INTERNAL',
+            approvedAt: new Date().toISOString(),
+            comments: reason,
+            decision: 'REJECTED',
+        };
+        __classPrivateFieldGet(this, _ReportInstance_approvals, "f").push(approval);
+        __classPrivateFieldSet(this, _ReportInstance_status, ReportInstanceStatus_1.ReportInstanceStatus.REJECTED, "f");
+        __classPrivateFieldSet(this, _ReportInstance_updatedAt, new Date().toISOString(), "f");
+    }
+    publish(pdfUrl) {
+        if (!this.canBePublished()) {
+            const reason = !this.isApproved()
+                ? `Invalid status: ${__classPrivateFieldGet(this, _ReportInstance_status, "f")}`
+                : 'Missing generated content';
+            throw ReportInstanceCannotBePublishedError_1.ReportInstanceCannotBePublishedError.create(this.id.toPrimitives(), __classPrivateFieldGet(this, _ReportInstance_status, "f"), reason);
+        }
+        __classPrivateFieldSet(this, _ReportInstance_pdfUrl, pdfUrl, "f");
+        __classPrivateFieldSet(this, _ReportInstance_status, ReportInstanceStatus_1.ReportInstanceStatus.PUBLISHED, "f");
+        __classPrivateFieldSet(this, _ReportInstance_updatedAt, new Date().toISOString(), "f");
+    }
+    addAiExecution(execution) {
+        __classPrivateFieldGet(this, _ReportInstance_aiExecutions, "f").push(execution);
+        __classPrivateFieldSet(this, _ReportInstance_updatedAt, new Date().toISOString(), "f");
+    }
+    // Helper methods
+    hasGeneratedContent() {
+        return __classPrivateFieldGet(this, _ReportInstance_generatedContent, "f") !== null && Object.keys(__classPrivateFieldGet(this, _ReportInstance_generatedContent, "f")).length > 0;
+    }
+    hasPdf() {
+        return __classPrivateFieldGet(this, _ReportInstance_pdfUrl, "f") !== null && __classPrivateFieldGet(this, _ReportInstance_pdfUrl, "f").trim() !== '';
+    }
+    requiresClientApproval() {
+        // TODO: This should be determined by the template's requiresClientApproval flag
+        // For now, we assume client approval is always required
+        return true;
+    }
+    getApprovalCount() {
+        return __classPrivateFieldGet(this, _ReportInstance_approvals, "f").length;
+    }
+    hasInternalApproval() {
+        return __classPrivateFieldGet(this, _ReportInstance_approvals, "f").some((approval) => approval.role === 'INTERNAL' && approval.decision === 'APPROVED');
+    }
+    hasClientApproval() {
+        return __classPrivateFieldGet(this, _ReportInstance_approvals, "f").some((approval) => approval.role === 'CLIENT' && approval.decision === 'APPROVED');
+    }
+    getDataSnapshotHash() {
+        // TODO: Implement hash calculation from dataSnapshot
+        return null;
+    }
+    getTotalAiExecutions() {
+        return __classPrivateFieldGet(this, _ReportInstance_aiExecutions, "f").length;
+    }
+}
+exports.ReportInstance = ReportInstance;
+_ReportInstance_templateId = new WeakMap(), _ReportInstance_templateVersion = new WeakMap(), _ReportInstance_carbonClientId = new WeakMap(), _ReportInstance_period = new WeakMap(), _ReportInstance_filters = new WeakMap(), _ReportInstance_questionnaireAnswers = new WeakMap(), _ReportInstance_dataSnapshot = new WeakMap(), _ReportInstance_generatedContent = new WeakMap(), _ReportInstance_pdfUrl = new WeakMap(), _ReportInstance_status = new WeakMap(), _ReportInstance_approvals = new WeakMap(), _ReportInstance_aiExecutions = new WeakMap(), _ReportInstance_createdAt = new WeakMap(), _ReportInstance_updatedAt = new WeakMap();

package/build/carbonbox/reporting/report-instances/domain/enums/ReportInstanceStatus.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportInstanceStatus = void 0;
+/**
+ * Report Instance Status enumeration
+ * Defines the lifecycle status of a report instance
+ */
+var ReportInstanceStatus;
+(function (ReportInstanceStatus) {
+    /**
+     * Draft - Report instance created but not yet generated
+     */
+    ReportInstanceStatus["DRAFT"] = "DRAFT";
+    /**
+     * Generating - AI is currently generating report content
+     */
+    ReportInstanceStatus["GENERATING"] = "GENERATING";
+    /**
+     * Pending Internal - Waiting for internal approval
+     */
+    ReportInstanceStatus["PENDING_INTERNAL"] = "PENDING_INTERNAL";
+    /**
+     * Pending Client - Waiting for client approval
+     */
+    ReportInstanceStatus["PENDING_CLIENT"] = "PENDING_CLIENT";
+    /**
+     * Approved - Report approved and ready for publication
+     */
+    ReportInstanceStatus["APPROVED"] = "APPROVED";
+    /**
+     * Published - Report published and PDF generated
+     */
+    ReportInstanceStatus["PUBLISHED"] = "PUBLISHED";
+    /**
+     * Rejected - Report rejected, needs revision
+     */
+    ReportInstanceStatus["REJECTED"] = "REJECTED";
+})(ReportInstanceStatus || (exports.ReportInstanceStatus = ReportInstanceStatus = {}));

package/build/carbonbox/reporting/report-instances/domain/exceptions/ReportInstanceCannotBeApprovedByClientError.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportInstanceCannotBeApprovedByClientError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class ReportInstanceCannotBeApprovedByClientError extends CodedRootError_1.CodedRootError {
+    constructor(instanceId, currentStatus, reason) {
+        const technicalMessage = `Report instance '${instanceId}' cannot be approved by client. Current status: ${currentStatus}. Reason: ${reason}`;
+        const context = {
+            instanceId,
+            currentStatus,
+            reason,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'Ensure the report instance is in PENDING_CLIENT status before attempting client approval',
+            'Verify that the report has received internal approval first',
+            'Check that the approver is authorized to represent the client',
+            `Review the report instance '${instanceId}' approval workflow`,
+            'Confirm that the template requires client approval',
+        ];
+        super(ErrorCode_1.ErrorCode.REPORT_INSTANCE_CANNOT_BE_APPROVED_BY_CLIENT, technicalMessage, context, suggestions);
+        this.name = 'ReportInstanceCannotBeApprovedByClientError';
+    }
+    static create(instanceId, currentStatus, reason) {
+        return new ReportInstanceCannotBeApprovedByClientError(instanceId, currentStatus, reason);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.ReportInstanceCannotBeApprovedByClientError = ReportInstanceCannotBeApprovedByClientError;

package/build/carbonbox/reporting/report-instances/domain/exceptions/ReportInstanceCannotBeApprovedInternallyError.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportInstanceCannotBeApprovedInternallyError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class ReportInstanceCannotBeApprovedInternallyError extends CodedRootError_1.CodedRootError {
+    constructor(instanceId, currentStatus, reason) {
+        const technicalMessage = `Report instance '${instanceId}' cannot be approved internally. Current status: ${currentStatus}. Reason: ${reason}`;
+        const context = {
+            instanceId,
+            currentStatus,
+            reason,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'Ensure the report instance is in PENDING_INTERNAL status before attempting internal approval',
+            'Verify that the report content has been properly generated',
+            'Check that the approver has the necessary permissions for internal approval',
+            `Review the report instance '${instanceId}' workflow state`,
+            'Confirm that all required validations have passed',
+        ];
+        super(ErrorCode_1.ErrorCode.REPORT_INSTANCE_CANNOT_BE_APPROVED_INTERNALLY, technicalMessage, context, suggestions);
+        this.name = 'ReportInstanceCannotBeApprovedInternallyError';
+    }
+    static create(instanceId, currentStatus, reason) {
+        return new ReportInstanceCannotBeApprovedInternallyError(instanceId, currentStatus, reason);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.ReportInstanceCannotBeApprovedInternallyError = ReportInstanceCannotBeApprovedInternallyError;

package/build/carbonbox/reporting/report-instances/domain/exceptions/ReportInstanceCannotBeGeneratedError.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportInstanceCannotBeGeneratedError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class ReportInstanceCannotBeGeneratedError extends CodedRootError_1.CodedRootError {
+    constructor(instanceId, currentStatus, reason) {
+        const technicalMessage = `Report instance '${instanceId}' cannot be generated. Current status: ${currentStatus}. Reason: ${reason}`;
+        const context = {
+            instanceId,
+            currentStatus,
+            reason,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'Ensure the report instance is in DRAFT or REJECTED status before attempting generation',
+            'Verify that the data snapshot has been properly created and contains valid data',
+            'Check that all required questionnaire answers have been provided',
+            `Review the report instance '${instanceId}' configuration and requirements`,
+            'Confirm that the associated template is active and properly configured',
+        ];
+        super(ErrorCode_1.ErrorCode.REPORT_INSTANCE_CANNOT_BE_GENERATED, technicalMessage, context, suggestions);
+        this.name = 'ReportInstanceCannotBeGeneratedError';
+    }
+    static create(instanceId, currentStatus, reason) {
+        return new ReportInstanceCannotBeGeneratedError(instanceId, currentStatus, reason);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.ReportInstanceCannotBeGeneratedError = ReportInstanceCannotBeGeneratedError;

package/build/carbonbox/reporting/report-instances/domain/exceptions/ReportInstanceCannotBePublishedError.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportInstanceCannotBePublishedError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class ReportInstanceCannotBePublishedError extends CodedRootError_1.CodedRootError {
+    constructor(instanceId, currentStatus, reason) {
+        const technicalMessage = `Report instance '${instanceId}' cannot be published. Current status: ${currentStatus}. Reason: ${reason}`;
+        const context = {
+            instanceId,
+            currentStatus,
+            reason,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'Ensure the report instance is in APPROVED status before attempting to publish',
+            'Verify that the PDF has been successfully generated',
+            'Check that all required approvals have been obtained',
+            `Review the report instance '${instanceId}' publication requirements`,
+            'Confirm that the generated content is valid and complete',
+        ];
+        super(ErrorCode_1.ErrorCode.REPORT_INSTANCE_CANNOT_BE_PUBLISHED, technicalMessage, context, suggestions);
+        this.name = 'ReportInstanceCannotBePublishedError';
+    }
+    static create(instanceId, currentStatus, reason) {
+        return new ReportInstanceCannotBePublishedError(instanceId, currentStatus, reason);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.ReportInstanceCannotBePublishedError = ReportInstanceCannotBePublishedError;

package/build/carbonbox/reporting/report-instances/domain/exceptions/ReportInstanceCannotBeRejectedError.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportInstanceCannotBeRejectedError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class ReportInstanceCannotBeRejectedError extends CodedRootError_1.CodedRootError {
+    constructor(instanceId, currentStatus, reason) {
+        const technicalMessage = `Report instance '${instanceId}' cannot be rejected. Current status: ${currentStatus}. Reason: ${reason}`;
+        const context = {
+            instanceId,
+            currentStatus,
+            reason,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'Ensure the report instance is in PENDING_INTERNAL or PENDING_CLIENT status before attempting rejection',
+            'Verify that the rejector has the necessary permissions',
+            'Provide a clear reason for the rejection',
+            `Review the report instance '${instanceId}' current workflow state`,
+            'Check that the rejection workflow is properly configured',
+        ];
+        super(ErrorCode_1.ErrorCode.REPORT_INSTANCE_CANNOT_BE_REJECTED, technicalMessage, context, suggestions);
+        this.name = 'ReportInstanceCannotBeRejectedError';
+    }
+    static create(instanceId, currentStatus, reason) {
+        return new ReportInstanceCannotBeRejectedError(instanceId, currentStatus, reason);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.ReportInstanceCannotBeRejectedError = ReportInstanceCannotBeRejectedError;

package/build/carbonbox/reporting/report-instances/domain/exceptions/ReportInstanceInvalidStatusTransitionError.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportInstanceInvalidStatusTransitionError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class ReportInstanceInvalidStatusTransitionError extends CodedRootError_1.CodedRootError {
+    constructor(instanceId, currentStatus, targetStatus) {
+        const technicalMessage = `Invalid status transition for report instance '${instanceId}'. Cannot transition from '${currentStatus}' to '${targetStatus}'.`;
+        const context = {
+            instanceId,
+            currentStatus,
+            targetStatus,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'Follow the valid status flow: DRAFT → GENERATING → PENDING_INTERNAL → (PENDING_CLIENT) → APPROVED → PUBLISHED',
+            `Current status '${currentStatus}' does not allow transition to '${targetStatus}'`,
+            'Review the report instance workflow state machine',
+            'Check that all required steps have been completed before attempting the transition',
+            `Verify the report instance '${instanceId}' meets all requirements for the target status`,
+        ];
+        super(ErrorCode_1.ErrorCode.REPORT_INSTANCE_INVALID_STATUS_TRANSITION, technicalMessage, context, suggestions);
+        this.name = 'ReportInstanceInvalidStatusTransitionError';
+    }
+    static create(instanceId, currentStatus, targetStatus) {
+        return new ReportInstanceInvalidStatusTransitionError(instanceId, currentStatus, targetStatus);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.ReportInstanceInvalidStatusTransitionError = ReportInstanceInvalidStatusTransitionError;

package/build/carbonbox/reporting/report-instances/domain/repository/IReportInstanceRepository.js

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

package/build/carbonbox/reporting/report-instances/domain/types/ReportInstancePrimitives.js

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

package/build/carbonbox/reporting/report-instances/domain/types/ReportInstanceProps.js

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

package/build/carbonbox/reporting/report-templates/domain/entity/IReportTemplate.js

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