@carbonbox/domain 0.52.0 → 0.54.0

package/build/carbonbox/carbon-footprint-audits/audit-engagements/domain/value-objects/AuditEngagementValidFrom.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditEngagementValidFrom = void 0;
+const DateTimeString_1 = require("../../../../shared/domain/value-objects/DateTimeString");
+/**
+ * Start of the access of an audit engagement (start of the first contract day).
+ */
+class AuditEngagementValidFrom extends DateTimeString_1.DateTimeString {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, AuditEngagementValidFrom.PROPERTY_NAME);
+    }
+    static create(value) {
+        DateTimeString_1.DateTimeString.guardAgainstEmptyValue(value, AuditEngagementValidFrom.PROPERTY_NAME);
+        DateTimeString_1.DateTimeString.guardAgainstInvalidType(value, AuditEngagementValidFrom.PROPERTY_NAME);
+        DateTimeString_1.DateTimeString.guardAgainstInvalidDateTimeFormat(value);
+        return new AuditEngagementValidFrom(value, false);
+    }
+    static fromPrimitives(primitive) {
+        const value = primitive;
+        return new AuditEngagementValidFrom(value, true);
+    }
+    /**
+     * Whether the access already started at the given moment (`DD/MM/YYYY HH:mm:ss`).
+     * The start moment itself already counts.
+     */
+    isReachedAt(moment) {
+        return moment.toDate().getTime() >= this.toDate().getTime();
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.AuditEngagementValidFrom = AuditEngagementValidFrom;
+AuditEngagementValidFrom.PROPERTY_NAME = 'validFrom';

package/build/carbonbox/carbon-footprint-audits/audit-engagements/domain/value-objects/AuditEngagementValidTo.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditEngagementValidTo = void 0;
+const DateTimeString_1 = require("../../../../shared/domain/value-objects/DateTimeString");
+/**
+ * End of the access of an audit engagement: the end of the last contract day (D15,
+ * `endDate 23:59:59`, the convention of the entitlements projection).
+ */
+class AuditEngagementValidTo extends DateTimeString_1.DateTimeString {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, AuditEngagementValidTo.PROPERTY_NAME);
+    }
+    static create(value) {
+        DateTimeString_1.DateTimeString.guardAgainstEmptyValue(value, AuditEngagementValidTo.PROPERTY_NAME);
+        DateTimeString_1.DateTimeString.guardAgainstInvalidType(value, AuditEngagementValidTo.PROPERTY_NAME);
+        DateTimeString_1.DateTimeString.guardAgainstInvalidDateTimeFormat(value);
+        return new AuditEngagementValidTo(value, false);
+    }
+    static fromPrimitives(primitive) {
+        const value = primitive;
+        return new AuditEngagementValidTo(value, true);
+    }
+    /**
+     * Whether the access already ended at the given moment (`DD/MM/YYYY HH:mm:ss`).
+     * The end moment itself still grants access: the last second of the last day counts.
+     */
+    isPassedAt(moment) {
+        return moment.toDate().getTime() > this.toDate().getTime();
+    }
+    /**
+     * Whether this end is strictly after the given moment (`DD/MM/YYYY HH:mm:ss`).
+     */
+    isAfter(moment) {
+        return this.toDate().getTime() > moment.toDate().getTime();
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.AuditEngagementValidTo = AuditEngagementValidTo;
+AuditEngagementValidTo.PROPERTY_NAME = 'validTo';

package/build/carbonbox/carbon-footprint-audits/audit-engagements/domain/value-objects/AuditedCarbonFootprintConfiguration.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditedCarbonFootprintConfiguration = void 0;
+const CarbonFootprintConfigurationReference_1 = require("../../../../shared/domain/value-objects/CarbonFootprintConfigurationReference");
+/**
+ * One carbon footprint configuration (id + footprint type) audited by an engagement.
+ */
+class AuditedCarbonFootprintConfiguration extends CarbonFootprintConfigurationReference_1.CarbonFootprintConfigurationReference {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, AuditedCarbonFootprintConfiguration.PROPERTY_NAME);
+    }
+    static create(value) {
+        return new AuditedCarbonFootprintConfiguration(value, false);
+    }
+    static fromPrimitives(primitives) {
+        const value = {
+            id: primitives.id,
+            footprintType: primitives.footprintType,
+        };
+        return new AuditedCarbonFootprintConfiguration(value, true);
+    }
+}
+exports.AuditedCarbonFootprintConfiguration = AuditedCarbonFootprintConfiguration;
+AuditedCarbonFootprintConfiguration.PROPERTY_NAME = 'auditedCarbonFootprintConfiguration';

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/entity/AuditFinding.js

@@ -0,0 +1,349 @@
+"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 _AuditFinding_instances, _AuditFinding_auditEngagementId, _AuditFinding_carbonClientId, _AuditFinding_carbonFootprintConfiguration, _AuditFinding_type, _AuditFinding_subject, _AuditFinding_title, _AuditFinding_description, _AuditFinding_estimatedImpactInTonnesCarbonDioxideEquivalent, _AuditFinding_status, _AuditFinding_responses, _AuditFinding_openedByCarbonAuditorId, _AuditFinding_openedAt, _AuditFinding_closedByCarbonAuditorId, _AuditFinding_closedAt, _AuditFinding_closureNote, _AuditFinding_evaluateAt, _AuditFinding_toProps, _AuditFinding_guardAgainstAnsweredWithoutResponses, _AuditFinding_guardAgainstInconsistentClosure;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditFinding = void 0;
+const AggregateRoot_1 = require("../../../../shared/domain/entities/AggregateRoot");
+const InvalidDateRangeError_1 = require("../../../../shared/domain/exceptions/InvalidDateRangeError");
+const InvalidPropertyValueError_1 = require("../../../../shared/domain/exceptions/InvalidPropertyValueError");
+const CarbonClientId_1 = require("../../../../stakeholders/carbon-clients/domain/value-objects/CarbonClientId");
+const AuditFindingStatus_1 = require("../enums/AuditFindingStatus");
+const AuditFindingId_1 = require("../value-objects/AuditFindingId");
+const AuditFindingAuditEngagementId_1 = require("../value-objects/AuditFindingAuditEngagementId");
+const AuditFindingCarbonFootprintConfiguration_1 = require("../value-objects/AuditFindingCarbonFootprintConfiguration");
+const AuditFindingType_1 = require("../value-objects/AuditFindingType");
+const AuditFindingSubject_1 = require("../value-objects/AuditFindingSubject");
+const AuditFindingTitle_1 = require("../value-objects/AuditFindingTitle");
+const AuditFindingDescription_1 = require("../value-objects/AuditFindingDescription");
+const AuditFindingEstimatedImpactInTonnesCarbonDioxideEquivalent_1 = require("../value-objects/AuditFindingEstimatedImpactInTonnesCarbonDioxideEquivalent");
+const AuditFindingStatus_2 = require("../value-objects/AuditFindingStatus");
+const AuditFindingResponses_1 = require("../value-objects/AuditFindingResponses");
+const AuditFindingOpenedByCarbonAuditorId_1 = require("../value-objects/AuditFindingOpenedByCarbonAuditorId");
+const AuditFindingOpenedAt_1 = require("../value-objects/AuditFindingOpenedAt");
+const AuditFindingClosedByCarbonAuditorId_1 = require("../value-objects/AuditFindingClosedByCarbonAuditorId");
+const AuditFindingClosedAt_1 = require("../value-objects/AuditFindingClosedAt");
+const AuditFindingClosureNote_1 = require("../value-objects/AuditFindingClosureNote");
+const AuditFindingEvaluatedAt_1 = require("../value-objects/AuditFindingEvaluatedAt");
+const AuditFindingInvalidStatusTransitionError_1 = require("../exceptions/AuditFindingInvalidStatusTransitionError");
+/**
+ * AuditFinding aggregate (AUD-D06, decisions D6, D11, D12): a request the auditor raises to the
+ * carbon client while verifying a carbon footprint — clarification (CL), corrective action (CAR) or
+ * forward action (FAR).
+ *
+ * The finding belongs to the carbon client, not to the auditor (D6): a later auditor of the same
+ * footprint sees it and may close it. The carbon client side answers (D11); only an auditor closes
+ * or reopens. CL and CAR need an answer before they can be closed and block the verification
+ * statement until closed (D12); a FAR can be closed without an answer and never blocks.
+ *
+ * The domain does not read the clock: every change receives the current moment
+ * (`DD/MM/YYYY HH:mm:ss`), which cannot be before the moment the finding was raised. Changes
+ * return a new instance.
+ *
+ * Lifecycle: OPEN → ANSWERED (answer) → CLOSED (close) → OPEN (reopen). Answering again keeps it
+ * ANSWERED and extends the thread; a FAR may also go OPEN → CLOSED.
+ */
+class AuditFinding extends AggregateRoot_1.AggregateRoot {
+    constructor(props, skipDomainValidation) {
+        const id = skipDomainValidation
+            ? AuditFindingId_1.AuditFindingId.fromPrimitives(props.id).toPrimitives()
+            : AuditFindingId_1.AuditFindingId.create(props.id).toPrimitives();
+        super({ id }, skipDomainValidation);
+        _AuditFinding_instances.add(this);
+        _AuditFinding_auditEngagementId.set(this, void 0);
+        _AuditFinding_carbonClientId.set(this, void 0);
+        _AuditFinding_carbonFootprintConfiguration.set(this, void 0);
+        _AuditFinding_type.set(this, void 0);
+        _AuditFinding_subject.set(this, void 0);
+        _AuditFinding_title.set(this, void 0);
+        _AuditFinding_description.set(this, void 0);
+        _AuditFinding_estimatedImpactInTonnesCarbonDioxideEquivalent.set(this, void 0);
+        _AuditFinding_status.set(this, void 0);
+        _AuditFinding_responses.set(this, void 0);
+        _AuditFinding_openedByCarbonAuditorId.set(this, void 0);
+        _AuditFinding_openedAt.set(this, void 0);
+        _AuditFinding_closedByCarbonAuditorId.set(this, void 0);
+        _AuditFinding_closedAt.set(this, void 0);
+        _AuditFinding_closureNote.set(this, void 0);
+        if (skipDomainValidation === false) {
+            // Initialize with domain validation
+            __classPrivateFieldSet(this, _AuditFinding_auditEngagementId, AuditFindingAuditEngagementId_1.AuditFindingAuditEngagementId.create(props.auditEngagementId), "f");
+            __classPrivateFieldSet(this, _AuditFinding_carbonClientId, CarbonClientId_1.CarbonClientId.create(props.carbonClientId), "f");
+            __classPrivateFieldSet(this, _AuditFinding_carbonFootprintConfiguration, AuditFindingCarbonFootprintConfiguration_1.AuditFindingCarbonFootprintConfiguration.create(props.carbonFootprintConfiguration), "f");
+            __classPrivateFieldSet(this, _AuditFinding_type, AuditFindingType_1.AuditFindingType.create(props.type), "f");
+            __classPrivateFieldSet(this, _AuditFinding_subject, AuditFindingSubject_1.AuditFindingSubject.create(props.subject), "f");
+            __classPrivateFieldSet(this, _AuditFinding_title, AuditFindingTitle_1.AuditFindingTitle.create(props.title), "f");
+            __classPrivateFieldSet(this, _AuditFinding_description, AuditFindingDescription_1.AuditFindingDescription.create(props.description), "f");
+            __classPrivateFieldSet(this, _AuditFinding_estimatedImpactInTonnesCarbonDioxideEquivalent, AuditFindingEstimatedImpactInTonnesCarbonDioxideEquivalent_1.AuditFindingEstimatedImpactInTonnesCarbonDioxideEquivalent.create(props.estimatedImpactInTonnesCarbonDioxideEquivalent), "f");
+            __classPrivateFieldSet(this, _AuditFinding_status, AuditFindingStatus_2.AuditFindingStatus.create(props.status), "f");
+            __classPrivateFieldSet(this, _AuditFinding_responses, AuditFindingResponses_1.AuditFindingResponses.create(props.responses), "f");
+            __classPrivateFieldSet(this, _AuditFinding_openedByCarbonAuditorId, AuditFindingOpenedByCarbonAuditorId_1.AuditFindingOpenedByCarbonAuditorId.create(props.openedByCarbonAuditorId), "f");
+            __classPrivateFieldSet(this, _AuditFinding_openedAt, AuditFindingOpenedAt_1.AuditFindingOpenedAt.create(props.openedAt), "f");
+            __classPrivateFieldSet(this, _AuditFinding_closedByCarbonAuditorId, AuditFindingClosedByCarbonAuditorId_1.AuditFindingClosedByCarbonAuditorId.create(props.closedByCarbonAuditorId), "f");
+            __classPrivateFieldSet(this, _AuditFinding_closedAt, AuditFindingClosedAt_1.AuditFindingClosedAt.create(props.closedAt), "f");
+            __classPrivateFieldSet(this, _AuditFinding_closureNote, AuditFindingClosureNote_1.AuditFindingClosureNote.create(props.closureNote), "f");
+            __classPrivateFieldGet(this, _AuditFinding_instances, "m", _AuditFinding_guardAgainstAnsweredWithoutResponses).call(this);
+            __classPrivateFieldGet(this, _AuditFinding_instances, "m", _AuditFinding_guardAgainstInconsistentClosure).call(this);
+        }
+        else {
+            // Initialize from primitives (no domain validation)
+            __classPrivateFieldSet(this, _AuditFinding_auditEngagementId, AuditFindingAuditEngagementId_1.AuditFindingAuditEngagementId.fromPrimitives(props.auditEngagementId), "f");
+            __classPrivateFieldSet(this, _AuditFinding_carbonClientId, CarbonClientId_1.CarbonClientId.fromPrimitives(props.carbonClientId), "f");
+            __classPrivateFieldSet(this, _AuditFinding_carbonFootprintConfiguration, AuditFindingCarbonFootprintConfiguration_1.AuditFindingCarbonFootprintConfiguration.fromPrimitives(props.carbonFootprintConfiguration), "f");
+            __classPrivateFieldSet(this, _AuditFinding_type, AuditFindingType_1.AuditFindingType.fromPrimitives(props.type), "f");
+            __classPrivateFieldSet(this, _AuditFinding_subject, AuditFindingSubject_1.AuditFindingSubject.fromPrimitives(props.subject), "f");
+            __classPrivateFieldSet(this, _AuditFinding_title, AuditFindingTitle_1.AuditFindingTitle.fromPrimitives(props.title), "f");
+            __classPrivateFieldSet(this, _AuditFinding_description, AuditFindingDescription_1.AuditFindingDescription.fromPrimitives(props.description), "f");
+            __classPrivateFieldSet(this, _AuditFinding_estimatedImpactInTonnesCarbonDioxideEquivalent, AuditFindingEstimatedImpactInTonnesCarbonDioxideEquivalent_1.AuditFindingEstimatedImpactInTonnesCarbonDioxideEquivalent.fromPrimitives(props.estimatedImpactInTonnesCarbonDioxideEquivalent), "f");
+            __classPrivateFieldSet(this, _AuditFinding_status, AuditFindingStatus_2.AuditFindingStatus.fromPrimitives(props.status), "f");
+            __classPrivateFieldSet(this, _AuditFinding_responses, AuditFindingResponses_1.AuditFindingResponses.fromPrimitives(props.responses), "f");
+            __classPrivateFieldSet(this, _AuditFinding_openedByCarbonAuditorId, AuditFindingOpenedByCarbonAuditorId_1.AuditFindingOpenedByCarbonAuditorId.fromPrimitives(props.openedByCarbonAuditorId), "f");
+            __classPrivateFieldSet(this, _AuditFinding_openedAt, AuditFindingOpenedAt_1.AuditFindingOpenedAt.fromPrimitives(props.openedAt), "f");
+            __classPrivateFieldSet(this, _AuditFinding_closedByCarbonAuditorId, AuditFindingClosedByCarbonAuditorId_1.AuditFindingClosedByCarbonAuditorId.fromPrimitives(props.closedByCarbonAuditorId), "f");
+            __classPrivateFieldSet(this, _AuditFinding_closedAt, AuditFindingClosedAt_1.AuditFindingClosedAt.fromPrimitives(props.closedAt), "f");
+            __classPrivateFieldSet(this, _AuditFinding_closureNote, AuditFindingClosureNote_1.AuditFindingClosureNote.fromPrimitives(props.closureNote), "f");
+        }
+    }
+    static create(props) {
+        return new AuditFinding(props, false);
+    }
+    /**
+     * Raises a new finding: OPEN, without answers and not closed.
+     */
+    static open(props) {
+        return new AuditFinding({
+            id: props.id,
+            auditEngagementId: props.auditEngagementId,
+            carbonClientId: props.carbonClientId,
+            carbonFootprintConfiguration: props.carbonFootprintConfiguration,
+            type: props.type,
+            subject: props.subject,
+            title: props.title,
+            description: props.description,
+            estimatedImpactInTonnesCarbonDioxideEquivalent: props.estimatedImpactInTonnesCarbonDioxideEquivalent,
+            status: AuditFindingStatus_1.AuditFindingStatus.OPEN,
+            responses: [],
+            openedByCarbonAuditorId: props.openedByCarbonAuditorId,
+            openedAt: props.openedAt,
+            closedByCarbonAuditorId: null,
+            closedAt: null,
+            closureNote: null,
+        }, false);
+    }
+    static fromPrimitives(primitives) {
+        const props = {
+            id: primitives.id,
+            auditEngagementId: primitives.auditEngagementId,
+            carbonClientId: primitives.carbonClientId,
+            carbonFootprintConfiguration: primitives.carbonFootprintConfiguration,
+            type: primitives.type,
+            subject: primitives.subject,
+            title: primitives.title,
+            description: primitives.description,
+            estimatedImpactInTonnesCarbonDioxideEquivalent: primitives.estimatedImpactInTonnesCarbonDioxideEquivalent,
+            status: primitives.status,
+            responses: primitives.responses,
+            openedByCarbonAuditorId: primitives.openedByCarbonAuditorId,
+            openedAt: primitives.openedAt,
+            closedByCarbonAuditorId: primitives.closedByCarbonAuditorId,
+            closedAt: primitives.closedAt,
+            closureNote: primitives.closureNote,
+        };
+        return new AuditFinding(props, true);
+    }
+    get toPrimitives() {
+        return __classPrivateFieldGet(this, _AuditFinding_instances, "m", _AuditFinding_toProps).call(this);
+    }
+    get auditEngagementId() {
+        return __classPrivateFieldGet(this, _AuditFinding_auditEngagementId, "f");
+    }
+    get carbonClientId() {
+        return __classPrivateFieldGet(this, _AuditFinding_carbonClientId, "f");
+    }
+    get carbonFootprintConfiguration() {
+        return __classPrivateFieldGet(this, _AuditFinding_carbonFootprintConfiguration, "f");
+    }
+    get type() {
+        return __classPrivateFieldGet(this, _AuditFinding_type, "f");
+    }
+    get subject() {
+        return __classPrivateFieldGet(this, _AuditFinding_subject, "f");
+    }
+    get title() {
+        return __classPrivateFieldGet(this, _AuditFinding_title, "f");
+    }
+    get description() {
+        return __classPrivateFieldGet(this, _AuditFinding_description, "f");
+    }
+    get estimatedImpactInTonnesCarbonDioxideEquivalent() {
+        return __classPrivateFieldGet(this, _AuditFinding_estimatedImpactInTonnesCarbonDioxideEquivalent, "f");
+    }
+    get status() {
+        return __classPrivateFieldGet(this, _AuditFinding_status, "f");
+    }
+    get responses() {
+        return __classPrivateFieldGet(this, _AuditFinding_responses, "f");
+    }
+    get openedByCarbonAuditorId() {
+        return __classPrivateFieldGet(this, _AuditFinding_openedByCarbonAuditorId, "f");
+    }
+    get openedAt() {
+        return __classPrivateFieldGet(this, _AuditFinding_openedAt, "f");
+    }
+    get closedByCarbonAuditorId() {
+        return __classPrivateFieldGet(this, _AuditFinding_closedByCarbonAuditorId, "f");
+    }
+    get closedAt() {
+        return __classPrivateFieldGet(this, _AuditFinding_closedAt, "f");
+    }
+    get closureNote() {
+        return __classPrivateFieldGet(this, _AuditFinding_closureNote, "f");
+    }
+    isOpen() {
+        return __classPrivateFieldGet(this, _AuditFinding_status, "f").isOpen();
+    }
+    isAnswered() {
+        return __classPrivateFieldGet(this, _AuditFinding_status, "f").isAnswered();
+    }
+    isClosed() {
+        return __classPrivateFieldGet(this, _AuditFinding_status, "f").isClosed();
+    }
+    /**
+     * Whether the finding keeps the verification statement from being issued (D12): a clarification
+     * or corrective action request that is not closed. A forward action request never blocks.
+     */
+    blocksVerificationStatement() {
+        return __classPrivateFieldGet(this, _AuditFinding_type, "f").requiresResolutionBeforeVerification() && __classPrivateFieldGet(this, _AuditFinding_status, "f").isClosed() === false;
+    }
+    /**
+     * Returns the finding with its content replaced at `now`. Only an OPEN finding can be edited
+     * (AuditFindingInvalidStatusTransitionError otherwise): once answered, the content the carbon
+     * client side answered to is kept.
+     */
+    update(now, changes) {
+        __classPrivateFieldGet(this, _AuditFinding_instances, "m", _AuditFinding_evaluateAt).call(this, now);
+        if (__classPrivateFieldGet(this, _AuditFinding_status, "f").isOpen() === false) {
+            throw AuditFindingInvalidStatusTransitionError_1.AuditFindingInvalidStatusTransitionError.create(__classPrivateFieldGet(this, _AuditFinding_status, "f").toPrimitives(), 'update');
+        }
+        return AuditFinding.create({
+            ...__classPrivateFieldGet(this, _AuditFinding_instances, "m", _AuditFinding_toProps).call(this),
+            type: changes.type,
+            subject: changes.subject,
+            title: changes.title,
+            description: changes.description,
+            estimatedImpactInTonnesCarbonDioxideEquivalent: changes.estimatedImpactInTonnesCarbonDioxideEquivalent,
+        });
+    }
+    /**
+     * Returns the finding answered at `now` by the carbon client side (D11): the answer is added to
+     * the thread and the finding becomes ANSWERED. An OPEN or ANSWERED finding can be answered; a
+     * CLOSED one cannot (AuditFindingInvalidStatusTransitionError). An auditor cannot answer
+     * (InvalidAuditFindingResponderError).
+     */
+    respond(now, respondedByStakeholder, message) {
+        const evaluatedAt = __classPrivateFieldGet(this, _AuditFinding_instances, "m", _AuditFinding_evaluateAt).call(this, now);
+        if (__classPrivateFieldGet(this, _AuditFinding_status, "f").isClosed()) {
+            throw AuditFindingInvalidStatusTransitionError_1.AuditFindingInvalidStatusTransitionError.create(__classPrivateFieldGet(this, _AuditFinding_status, "f").toPrimitives(), 'respond to');
+        }
+        return AuditFinding.create({
+            ...__classPrivateFieldGet(this, _AuditFinding_instances, "m", _AuditFinding_toProps).call(this),
+            status: AuditFindingStatus_1.AuditFindingStatus.ANSWERED,
+            responses: [
+                ...__classPrivateFieldGet(this, _AuditFinding_responses, "f").toPrimitives(),
+                {
+                    respondedByStakeholder,
+                    message,
+                    respondedAt: evaluatedAt.toPrimitives(),
+                },
+            ],
+        });
+    }
+    /**
+     * Returns the finding closed at `now` by a carbon auditor, with an optional note. A clarification
+     * or corrective action request can only be closed once ANSWERED; a forward action request can be
+     * closed while OPEN or ANSWERED. Closing a CLOSED finding is rejected
+     * (AuditFindingInvalidStatusTransitionError).
+     */
+    close(now, closedByCarbonAuditorId, closureNote) {
+        const evaluatedAt = __classPrivateFieldGet(this, _AuditFinding_instances, "m", _AuditFinding_evaluateAt).call(this, now);
+        if (__classPrivateFieldGet(this, _AuditFinding_status, "f").isClosed()) {
+            throw AuditFindingInvalidStatusTransitionError_1.AuditFindingInvalidStatusTransitionError.create(__classPrivateFieldGet(this, _AuditFinding_status, "f").toPrimitives(), 'close');
+        }
+        if (__classPrivateFieldGet(this, _AuditFinding_type, "f").requiresResolutionBeforeVerification() && __classPrivateFieldGet(this, _AuditFinding_status, "f").isOpen()) {
+            throw AuditFindingInvalidStatusTransitionError_1.AuditFindingInvalidStatusTransitionError.create(__classPrivateFieldGet(this, _AuditFinding_status, "f").toPrimitives(), 'close', 'a clarification or corrective action request must be answered before it is closed');
+        }
+        return AuditFinding.create({
+            ...__classPrivateFieldGet(this, _AuditFinding_instances, "m", _AuditFinding_toProps).call(this),
+            status: AuditFindingStatus_1.AuditFindingStatus.CLOSED,
+            closedByCarbonAuditorId,
+            closedAt: evaluatedAt.toPrimitives(),
+            closureNote,
+        });
+    }
+    /**
+     * Returns the finding reopened at `now`: OPEN again, keeping its thread, without closure data.
+     * Only a CLOSED finding can be reopened (AuditFindingInvalidStatusTransitionError otherwise).
+     */
+    reopen(now) {
+        __classPrivateFieldGet(this, _AuditFinding_instances, "m", _AuditFinding_evaluateAt).call(this, now);
+        if (__classPrivateFieldGet(this, _AuditFinding_status, "f").isClosed() === false) {
+            throw AuditFindingInvalidStatusTransitionError_1.AuditFindingInvalidStatusTransitionError.create(__classPrivateFieldGet(this, _AuditFinding_status, "f").toPrimitives(), 'reopen');
+        }
+        return AuditFinding.create({
+            ...__classPrivateFieldGet(this, _AuditFinding_instances, "m", _AuditFinding_toProps).call(this),
+            status: AuditFindingStatus_1.AuditFindingStatus.OPEN,
+            closedByCarbonAuditorId: null,
+            closedAt: null,
+            closureNote: null,
+        });
+    }
+}
+exports.AuditFinding = AuditFinding;
+_AuditFinding_auditEngagementId = new WeakMap(), _AuditFinding_carbonClientId = new WeakMap(), _AuditFinding_carbonFootprintConfiguration = new WeakMap(), _AuditFinding_type = new WeakMap(), _AuditFinding_subject = new WeakMap(), _AuditFinding_title = new WeakMap(), _AuditFinding_description = new WeakMap(), _AuditFinding_estimatedImpactInTonnesCarbonDioxideEquivalent = new WeakMap(), _AuditFinding_status = new WeakMap(), _AuditFinding_responses = new WeakMap(), _AuditFinding_openedByCarbonAuditorId = new WeakMap(), _AuditFinding_openedAt = new WeakMap(), _AuditFinding_closedByCarbonAuditorId = new WeakMap(), _AuditFinding_closedAt = new WeakMap(), _AuditFinding_closureNote = new WeakMap(), _AuditFinding_instances = new WeakSet(), _AuditFinding_evaluateAt = function _AuditFinding_evaluateAt(now) {
+    const evaluatedAt = AuditFindingEvaluatedAt_1.AuditFindingEvaluatedAt.create(now);
+    if (evaluatedAt.toDate().getTime() < __classPrivateFieldGet(this, _AuditFinding_openedAt, "f").toDate().getTime()) {
+        throw InvalidDateRangeError_1.InvalidDateRangeError.create(__classPrivateFieldGet(this, _AuditFinding_openedAt, "f").toPrimitives(), evaluatedAt.toPrimitives());
+    }
+    return evaluatedAt;
+}, _AuditFinding_toProps = function _AuditFinding_toProps() {
+    return {
+        id: this.id.toPrimitives(),
+        auditEngagementId: __classPrivateFieldGet(this, _AuditFinding_auditEngagementId, "f").toPrimitives(),
+        carbonClientId: __classPrivateFieldGet(this, _AuditFinding_carbonClientId, "f").toPrimitives(),
+        carbonFootprintConfiguration: __classPrivateFieldGet(this, _AuditFinding_carbonFootprintConfiguration, "f").toPrimitives(),
+        type: __classPrivateFieldGet(this, _AuditFinding_type, "f").toEnum(),
+        subject: __classPrivateFieldGet(this, _AuditFinding_subject, "f").toPrimitives(),
+        title: __classPrivateFieldGet(this, _AuditFinding_title, "f").toPrimitives(),
+        description: __classPrivateFieldGet(this, _AuditFinding_description, "f").toPrimitives(),
+        estimatedImpactInTonnesCarbonDioxideEquivalent: __classPrivateFieldGet(this, _AuditFinding_estimatedImpactInTonnesCarbonDioxideEquivalent, "f").toPrimitives(),
+        status: __classPrivateFieldGet(this, _AuditFinding_status, "f").toEnum(),
+        responses: __classPrivateFieldGet(this, _AuditFinding_responses, "f").toPrimitives(),
+        openedByCarbonAuditorId: __classPrivateFieldGet(this, _AuditFinding_openedByCarbonAuditorId, "f").toPrimitives(),
+        openedAt: __classPrivateFieldGet(this, _AuditFinding_openedAt, "f").toPrimitives(),
+        closedByCarbonAuditorId: __classPrivateFieldGet(this, _AuditFinding_closedByCarbonAuditorId, "f").toPrimitives(),
+        closedAt: __classPrivateFieldGet(this, _AuditFinding_closedAt, "f").toPrimitives(),
+        closureNote: __classPrivateFieldGet(this, _AuditFinding_closureNote, "f").toPrimitives(),
+    };
+}, _AuditFinding_guardAgainstAnsweredWithoutResponses = function _AuditFinding_guardAgainstAnsweredWithoutResponses() {
+    if (__classPrivateFieldGet(this, _AuditFinding_status, "f").isAnswered() && __classPrivateFieldGet(this, _AuditFinding_responses, "f").hasResponses() === false) {
+        throw InvalidPropertyValueError_1.InvalidPropertyValueError.create('responses', 'at least one answer when the finding is ANSWERED', 'no answers');
+    }
+}, _AuditFinding_guardAgainstInconsistentClosure = function _AuditFinding_guardAgainstInconsistentClosure() {
+    const isClosed = __classPrivateFieldGet(this, _AuditFinding_status, "f").isClosed();
+    if (isClosed && (__classPrivateFieldGet(this, _AuditFinding_closedAt, "f").hasValue() === false || __classPrivateFieldGet(this, _AuditFinding_closedByCarbonAuditorId, "f").hasValue() === false)) {
+        throw InvalidPropertyValueError_1.InvalidPropertyValueError.create('closedAt', 'the closing moment and auditor when the finding is CLOSED', 'missing closure data');
+    }
+    if (isClosed === false
+        && (__classPrivateFieldGet(this, _AuditFinding_closedAt, "f").hasValue() || __classPrivateFieldGet(this, _AuditFinding_closedByCarbonAuditorId, "f").hasValue() || __classPrivateFieldGet(this, _AuditFinding_closureNote, "f").hasValue())) {
+        throw InvalidPropertyValueError_1.InvalidPropertyValueError.create('closedAt', 'null closure data while the finding is not CLOSED', 'closure data');
+    }
+};

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/entity/IAuditFinding.js

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

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/enums/AuditFindingStatus.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditFindingStatus = void 0;
+/**
+ * Audit finding status enumeration (AUD-D06)
+ * The carbon client side answers a finding; only the auditor closes or reopens it.
+ */
+var AuditFindingStatus;
+(function (AuditFindingStatus) {
+    /**
+     * Raised by the auditor (or reopened) and waiting for an answer
+     */
+    AuditFindingStatus["OPEN"] = "OPEN";
+    /**
+     * The carbon client side answered; waiting for the auditor to close it or ask again
+     */
+    AuditFindingStatus["ANSWERED"] = "ANSWERED";
+    /**
+     * Closed by the auditor
+     */
+    AuditFindingStatus["CLOSED"] = "CLOSED";
+})(AuditFindingStatus || (exports.AuditFindingStatus = AuditFindingStatus = {}));

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/enums/AuditFindingSubjectType.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditFindingSubjectType = void 0;
+/**
+ * Audit finding subject type enumeration (AUD-D06)
+ * Kind of resource a finding points to. Every subject carries the id of the resource except
+ * GENERAL, which is about the audited footprint as a whole.
+ */
+var AuditFindingSubjectType;
+(function (AuditFindingSubjectType) {
+    /**
+     * The carbon footprint configuration (boundaries, base year, period, segments)
+     */
+    AuditFindingSubjectType["CARBON_FOOTPRINT_CONFIGURATION"] = "CARBON_FOOTPRINT_CONFIGURATION";
+    /**
+     * A facility of the carbon client
+     */
+    AuditFindingSubjectType["FACILITY"] = "FACILITY";
+    /**
+     * An activity data submission (the data and its source document)
+     */
+    AuditFindingSubjectType["ACTIVITY_DATA_SUBMISSION"] = "ACTIVITY_DATA_SUBMISSION";
+    /**
+     * A calculation process of the audited footprint
+     */
+    AuditFindingSubjectType["CALCULATION_PROCESS"] = "CALCULATION_PROCESS";
+    /**
+     * A single emission calculation line of a calculation process
+     */
+    AuditFindingSubjectType["EMISSION_CALCULATION"] = "EMISSION_CALCULATION";
+    /**
+     * An emission factor used by the calculations
+     */
+    AuditFindingSubjectType["EMISSION_FACTOR"] = "EMISSION_FACTOR";
+    /**
+     * An emission calculation formula used by the calculations
+     */
+    AuditFindingSubjectType["EMISSION_CALCULATION_FORMULA"] = "EMISSION_CALCULATION_FORMULA";
+    /**
+     * A report instance of the audited footprint
+     */
+    AuditFindingSubjectType["REPORT_INSTANCE"] = "REPORT_INSTANCE";
+    /**
+     * The audited footprint as a whole (no specific resource)
+     */
+    AuditFindingSubjectType["GENERAL"] = "GENERAL";
+})(AuditFindingSubjectType || (exports.AuditFindingSubjectType = AuditFindingSubjectType = {}));

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/enums/AuditFindingType.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditFindingType = void 0;
+/**
+ * Audit finding type enumeration (AUD-D06, ISO 14064-3 practice of verification bodies)
+ * Kind of request the auditor raises to the carbon client during the verification.
+ */
+var AuditFindingType;
+(function (AuditFindingType) {
+    /**
+     * Clarification request (CL): the auditor asks for information. Blocks the verification statement until closed
+     */
+    AuditFindingType["CLARIFICATION_REQUEST"] = "CLARIFICATION_REQUEST";
+    /**
+     * Corrective action request (CAR): there is an error to correct. Blocks the verification statement until closed
+     */
+    AuditFindingType["CORRECTIVE_ACTION_REQUEST"] = "CORRECTIVE_ACTION_REQUEST";
+    /**
+     * Forward action request (FAR): something to improve in the next period. Never blocks the statement
+     */
+    AuditFindingType["FORWARD_ACTION_REQUEST"] = "FORWARD_ACTION_REQUEST";
+})(AuditFindingType || (exports.AuditFindingType = AuditFindingType = {}));

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/exceptions/AuditFindingInvalidStatusTransitionError.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditFindingInvalidStatusTransitionError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+/**
+ * The action is not allowed in the current status of the audit finding (for example, editing an
+ * ANSWERED finding or closing a clarification request nobody answered yet).
+ */
+class AuditFindingInvalidStatusTransitionError extends CodedRootError_1.CodedRootError {
+    constructor(currentStatus, action, reason) {
+        const technicalMessage = reason === null
+            ? `Cannot ${action} an audit finding in status '${currentStatus}'.`
+            : `Cannot ${action} an audit finding in status '${currentStatus}': ${reason}`;
+        const context = {
+            currentStatus,
+            action,
+            reason,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'Edit a finding only while it is OPEN',
+            'Answer a finding while it is OPEN or ANSWERED',
+            'Close a clarification or corrective action request once it was answered; a forward action request can be closed while OPEN',
+            'Reopen only a CLOSED finding',
+        ];
+        super(ErrorCode_1.ErrorCode.AUDIT_FINDING_INVALID_STATUS_TRANSITION, technicalMessage, context, suggestions);
+        this.name = 'AuditFindingInvalidStatusTransitionError';
+    }
+    static create(currentStatus, action, reason = null) {
+        return new AuditFindingInvalidStatusTransitionError(currentStatus, action, reason);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.AuditFindingInvalidStatusTransitionError = AuditFindingInvalidStatusTransitionError;

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/exceptions/InvalidAuditFindingResponderError.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidAuditFindingResponderError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+/**
+ * D11: audit findings are answered by the carbon client side (client, coordinator, manager, host).
+ * An auditor raises and closes findings, never answers them.
+ */
+class InvalidAuditFindingResponderError extends CodedRootError_1.CodedRootError {
+    constructor(roleType, allowedRoles) {
+        const technicalMessage = `A stakeholder with role '${roleType}' cannot answer an audit finding.`;
+        const context = {
+            roleType,
+            allowedRoles: Array.from(allowedRoles),
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            `Answer the finding as one of: ${allowedRoles.join(', ')}`,
+            'An auditor closes or reopens a finding instead of answering it',
+        ];
+        super(ErrorCode_1.ErrorCode.INVALID_AUDIT_FINDING_RESPONDER, technicalMessage, context, suggestions);
+        this.name = 'InvalidAuditFindingResponderError';
+    }
+    static create(roleType, allowedRoles) {
+        return new InvalidAuditFindingResponderError(roleType, allowedRoles);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.InvalidAuditFindingResponderError = InvalidAuditFindingResponderError;