@carbonbox/domain 0.51.0 → 0.53.0

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

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidAuditFindingStatusError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class InvalidAuditFindingStatusError extends CodedRootError_1.CodedRootError {
+    constructor(invalidValue, validValues, propertyName) {
+        const technicalMessage = `Audit finding ${propertyName} constraint violation: '${invalidValue}' is not a valid audit finding status.`;
+        const context = {
+            propertyName,
+            receivedValue: invalidValue,
+            validValues,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            `Use one of the valid audit finding statuses: ${validValues.join(', ')}`,
+            'Change the status through the finding transitions (respond, close, reopen) instead of setting it',
+        ];
+        super(ErrorCode_1.ErrorCode.INVALID_AUDIT_FINDING_STATUS, technicalMessage, context, suggestions);
+        this.name = 'InvalidAuditFindingStatusError';
+    }
+    static create(invalidValue, validValues, propertyName = 'status') {
+        return new InvalidAuditFindingStatusError(invalidValue, validValues, propertyName);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.InvalidAuditFindingStatusError = InvalidAuditFindingStatusError;

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

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidAuditFindingSubjectError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+/**
+ * The resource an audit finding points to is not valid: unknown subject type, a missing id for a
+ * specific resource, or an id for a GENERAL subject.
+ */
+class InvalidAuditFindingSubjectError extends CodedRootError_1.CodedRootError {
+    constructor(reason) {
+        const technicalMessage = `Invalid audit finding subject: ${reason}`;
+        const context = {
+            reason,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'subjectType must be a value of AuditFindingSubjectType',
+            'With subjectType GENERAL, subjectId must be null',
+            'With any other subjectType, subjectId must be the non-empty id of the resource',
+        ];
+        super(ErrorCode_1.ErrorCode.INVALID_AUDIT_FINDING_SUBJECT, technicalMessage, context, suggestions);
+        this.name = 'InvalidAuditFindingSubjectError';
+    }
+    static create(reason) {
+        return new InvalidAuditFindingSubjectError(reason);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.InvalidAuditFindingSubjectError = InvalidAuditFindingSubjectError;

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

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidAuditFindingTypeError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class InvalidAuditFindingTypeError extends CodedRootError_1.CodedRootError {
+    constructor(invalidValue, validValues, propertyName) {
+        const technicalMessage = `Audit finding ${propertyName} constraint violation: '${invalidValue}' is not a valid audit finding type.`;
+        const context = {
+            propertyName,
+            receivedValue: invalidValue,
+            validValues,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            `Use one of the valid audit finding types: ${validValues.join(', ')}`,
+            'CLARIFICATION_REQUEST asks for information, CORRECTIVE_ACTION_REQUEST asks to fix an error, FORWARD_ACTION_REQUEST asks for an improvement next period',
+        ];
+        super(ErrorCode_1.ErrorCode.INVALID_AUDIT_FINDING_TYPE, technicalMessage, context, suggestions);
+        this.name = 'InvalidAuditFindingTypeError';
+    }
+    static create(invalidValue, validValues, propertyName = 'type') {
+        return new InvalidAuditFindingTypeError(invalidValue, validValues, propertyName);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.InvalidAuditFindingTypeError = InvalidAuditFindingTypeError;

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/repository/IAuditFindingRepository.js

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

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/types/AuditFindingOpenProps.js

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

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/types/AuditFindingPrimitives.js

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

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/types/AuditFindingProps.js

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

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/types/AuditFindingResponsePrimitives.js

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

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/types/AuditFindingSubjectPrimitives.js

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

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/types/AuditFindingUpdateProps.js

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

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/value-objects/AuditFindingAuditEngagementId.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditFindingAuditEngagementId = void 0;
+const AggregateId_1 = require("../../../../shared/domain/value-objects/AggregateId");
+const SemanticUuidPrefix_1 = require("../../../../shared/domain/enums/SemanticUuidPrefix");
+const InvalidAggregatePrefixError_1 = require("../../../../shared/domain/exceptions/InvalidAggregatePrefixError");
+/**
+ * Audit engagement during which a finding was raised (`CFA-ENG_<id>`).
+ */
+class AuditFindingAuditEngagementId extends AggregateId_1.AggregateId {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, AuditFindingAuditEngagementId.PROPERTY_NAME);
+    }
+    static create(value) {
+        AggregateId_1.AggregateId.guardAgainstEmptyValue(value, AuditFindingAuditEngagementId.PROPERTY_NAME);
+        AggregateId_1.AggregateId.guardAgainstInvalidType(value, AuditFindingAuditEngagementId.PROPERTY_NAME);
+        AggregateId_1.AggregateId.guardAgainstInvalidId(value, AuditFindingAuditEngagementId.PROPERTY_NAME);
+        // Validate that the prefix is valid for AuditEngagement
+        AuditFindingAuditEngagementId.guardAgainstInvalidPrefix(value);
+        return new AuditFindingAuditEngagementId(value, false);
+    }
+    /**
+     * Validates that the id has the AuditEngagement prefix.
+     * The id format was already validated, so the prefix can be extracted safely.
+     */
+    static guardAgainstInvalidPrefix(value) {
+        const prefix = new AuditFindingAuditEngagementId(value, true).extractPrefix();
+        if (AuditFindingAuditEngagementId.VALID_PREFIXES.includes(prefix) === false) {
+            throw InvalidAggregatePrefixError_1.InvalidAggregatePrefixError.create(value, 'AuditEngagement', prefix, AuditFindingAuditEngagementId.VALID_PREFIXES, AuditFindingAuditEngagementId.PROPERTY_NAME);
+        }
+    }
+    static fromPrimitives(primitive) {
+        const value = primitive;
+        return new AuditFindingAuditEngagementId(value, true);
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.AuditFindingAuditEngagementId = AuditFindingAuditEngagementId;
+AuditFindingAuditEngagementId.PROPERTY_NAME = 'auditEngagementId';
+AuditFindingAuditEngagementId.VALID_PREFIXES = [
+    SemanticUuidPrefix_1.SemanticUuidPrefix.CFA_AUDIT_ENGAGEMENT,
+];

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/value-objects/AuditFindingCarbonFootprintConfiguration.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditFindingCarbonFootprintConfiguration = void 0;
+const CarbonFootprintConfigurationReference_1 = require("../../../../shared/domain/value-objects/CarbonFootprintConfigurationReference");
+/**
+ * Audited carbon footprint configuration an audit finding is about.
+ */
+class AuditFindingCarbonFootprintConfiguration extends CarbonFootprintConfigurationReference_1.CarbonFootprintConfigurationReference {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, AuditFindingCarbonFootprintConfiguration.PROPERTY_NAME);
+    }
+    static create(value) {
+        return new AuditFindingCarbonFootprintConfiguration(value, false);
+    }
+    static fromPrimitives(primitives) {
+        const value = {
+            id: primitives.id,
+            footprintType: primitives.footprintType,
+        };
+        return new AuditFindingCarbonFootprintConfiguration(value, true);
+    }
+    toPrimitives() {
+        return {
+            id: this.id,
+            footprintType: this.footprintType,
+        };
+    }
+}
+exports.AuditFindingCarbonFootprintConfiguration = AuditFindingCarbonFootprintConfiguration;
+AuditFindingCarbonFootprintConfiguration.PROPERTY_NAME = 'carbonFootprintConfiguration';

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/value-objects/AuditFindingClosedAt.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditFindingClosedAt = void 0;
+const NullableDateTimeString_1 = require("../../../../shared/domain/value-objects/NullableDateTimeString");
+class AuditFindingClosedAt extends NullableDateTimeString_1.NullableDateTimeString {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, AuditFindingClosedAt.PROPERTY_NAME);
+    }
+    static create(value) {
+        return new AuditFindingClosedAt(value, false);
+    }
+    static fromPrimitives(primitive) {
+        const value = primitive;
+        return new AuditFindingClosedAt(value, true);
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.AuditFindingClosedAt = AuditFindingClosedAt;
+AuditFindingClosedAt.PROPERTY_NAME = 'closedAt';

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/value-objects/AuditFindingClosedByCarbonAuditorId.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditFindingClosedByCarbonAuditorId = void 0;
+const ValueObject_1 = require("../../../../shared/domain/value-objects/ValueObject");
+const UserId_1 = require("../../../../shared/domain/value-objects/UserId");
+const SemanticUuidPrefix_1 = require("../../../../shared/domain/enums/SemanticUuidPrefix");
+const InvalidUserPrefixError_1 = require("../../../../shared/domain/exceptions/InvalidUserPrefixError");
+/**
+ * Carbon auditor who closed an audit finding (`USR-STH-AUD_<id>`), or null while not closed.
+ * It may differ from the auditor who raised it (D6: a later auditor inherits the findings).
+ */
+class AuditFindingClosedByCarbonAuditorId extends ValueObject_1.ValueObject {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, AuditFindingClosedByCarbonAuditorId.PROPERTY_NAME, 'string | null', { allowNull: true, allowUndefined: false });
+        if (skipDomainValidation === false && value !== null) {
+            AuditFindingClosedByCarbonAuditorId.guardAgainstInvalidCarbonAuditorId(value);
+        }
+    }
+    static create(value) {
+        return new AuditFindingClosedByCarbonAuditorId(value, false);
+    }
+    static fromPrimitives(primitive) {
+        const value = primitive;
+        return new AuditFindingClosedByCarbonAuditorId(value, true);
+    }
+    /**
+     * Validates the user id format and that its prefix belongs to a carbon auditor.
+     */
+    static guardAgainstInvalidCarbonAuditorId(value) {
+        const prefix = UserId_1.UserId.create(value).extractPrefix();
+        if (AuditFindingClosedByCarbonAuditorId.VALID_PREFIXES.includes(prefix) === false) {
+            throw InvalidUserPrefixError_1.InvalidUserPrefixError.create(value, prefix, AuditFindingClosedByCarbonAuditorId.VALID_PREFIXES);
+        }
+    }
+    hasValue() {
+        return this.value !== null;
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.AuditFindingClosedByCarbonAuditorId = AuditFindingClosedByCarbonAuditorId;
+AuditFindingClosedByCarbonAuditorId.PROPERTY_NAME = 'closedByCarbonAuditorId';
+AuditFindingClosedByCarbonAuditorId.VALID_PREFIXES = [
+    SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_AUDITOR,
+];

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/value-objects/AuditFindingClosureNote.js

@@ -0,0 +1,41 @@
+"use strict";
+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 _AuditFindingClosureNote_instances, _a, _AuditFindingClosureNote_guardAgainstInvalidLength;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditFindingClosureNote = void 0;
+const NullableString_1 = require("../../../../shared/domain/value-objects/NullableString");
+const InvalidPropertyValueError_1 = require("../../../../shared/domain/exceptions/InvalidPropertyValueError");
+/**
+ * Note the auditor leaves when closing a finding, or null (a finding can be closed without a note).
+ */
+class AuditFindingClosureNote extends NullableString_1.NullableString {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, _a.PROPERTY_NAME);
+        _AuditFindingClosureNote_instances.add(this);
+        if (skipDomainValidation === false && value !== null) {
+            __classPrivateFieldGet(this, _AuditFindingClosureNote_instances, "m", _AuditFindingClosureNote_guardAgainstInvalidLength).call(this, value);
+        }
+    }
+    static create(value) {
+        return new _a(value, false);
+    }
+    static fromPrimitives(primitive) {
+        const value = primitive;
+        return new _a(value, true);
+    }
+    toPrimitives() {
+        return this.value === null ? null : this.value.trim();
+    }
+}
+exports.AuditFindingClosureNote = AuditFindingClosureNote;
+_a = AuditFindingClosureNote, _AuditFindingClosureNote_instances = new WeakSet(), _AuditFindingClosureNote_guardAgainstInvalidLength = function _AuditFindingClosureNote_guardAgainstInvalidLength(value) {
+    if (value.trim().length > _a.MAX_LENGTH) {
+        throw InvalidPropertyValueError_1.InvalidPropertyValueError.create(_a.PROPERTY_NAME, `at most ${_a.MAX_LENGTH} characters`, `${value.trim().length} characters`);
+    }
+};
+AuditFindingClosureNote.PROPERTY_NAME = 'closureNote';
+AuditFindingClosureNote.MAX_LENGTH = 5000;

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/value-objects/AuditFindingDescription.js

@@ -0,0 +1,40 @@
+"use strict";
+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 _AuditFindingDescription_instances, _a, _AuditFindingDescription_guardAgainstInvalidLength;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditFindingDescription = void 0;
+const String_1 = require("../../../../shared/domain/value-objects/String");
+const InvalidPropertyValueError_1 = require("../../../../shared/domain/exceptions/InvalidPropertyValueError");
+class AuditFindingDescription extends String_1.String {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, _a.PROPERTY_NAME);
+        _AuditFindingDescription_instances.add(this);
+        if (skipDomainValidation === false) {
+            __classPrivateFieldGet(this, _AuditFindingDescription_instances, "m", _AuditFindingDescription_guardAgainstInvalidLength).call(this, value);
+        }
+    }
+    static create(value) {
+        String_1.String.guardAgainstEmptyValue(value, _a.PROPERTY_NAME);
+        String_1.String.guardAgainstInvalidType(value, _a.PROPERTY_NAME);
+        return new _a(value, false);
+    }
+    static fromPrimitives(primitive) {
+        const value = primitive;
+        return new _a(value, true);
+    }
+    toPrimitives() {
+        return this.value.trim();
+    }
+}
+exports.AuditFindingDescription = AuditFindingDescription;
+_a = AuditFindingDescription, _AuditFindingDescription_instances = new WeakSet(), _AuditFindingDescription_guardAgainstInvalidLength = function _AuditFindingDescription_guardAgainstInvalidLength(value) {
+    if (value.trim().length > _a.MAX_LENGTH) {
+        throw InvalidPropertyValueError_1.InvalidPropertyValueError.create(_a.PROPERTY_NAME, `at most ${_a.MAX_LENGTH} characters`, `${value.trim().length} characters`);
+    }
+};
+AuditFindingDescription.PROPERTY_NAME = 'description';
+AuditFindingDescription.MAX_LENGTH = 5000;

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/value-objects/AuditFindingEstimatedImpactInTonnesCarbonDioxideEquivalent.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditFindingEstimatedImpactInTonnesCarbonDioxideEquivalent = void 0;
+const NullableNumeric_1 = require("../../../../shared/domain/value-objects/NullableNumeric");
+/**
+ * Estimated impact of an audit finding on the inventory, in tonnes of CO₂ equivalent, or null when
+ * the auditor did not estimate it. Finite and not negative (it is a magnitude, not a direction).
+ */
+class AuditFindingEstimatedImpactInTonnesCarbonDioxideEquivalent extends NullableNumeric_1.NullableNumeric {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, AuditFindingEstimatedImpactInTonnesCarbonDioxideEquivalent.PROPERTY_NAME, AuditFindingEstimatedImpactInTonnesCarbonDioxideEquivalent.OPTIONS);
+    }
+    static create(value) {
+        return new AuditFindingEstimatedImpactInTonnesCarbonDioxideEquivalent(value, false);
+    }
+    static fromPrimitives(primitive) {
+        const value = primitive;
+        return new AuditFindingEstimatedImpactInTonnesCarbonDioxideEquivalent(value, true);
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.AuditFindingEstimatedImpactInTonnesCarbonDioxideEquivalent = AuditFindingEstimatedImpactInTonnesCarbonDioxideEquivalent;
+AuditFindingEstimatedImpactInTonnesCarbonDioxideEquivalent.PROPERTY_NAME = 'estimatedImpactInTonnesCarbonDioxideEquivalent';
+AuditFindingEstimatedImpactInTonnesCarbonDioxideEquivalent.OPTIONS = {
+    allowNegative: false,
+    allowZero: true,
+    allowDecimals: true,
+    maxDecimalPlaces: 10,
+    minValue: 0,
+    maxValue: Number.MAX_SAFE_INTEGER,
+};

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/value-objects/AuditFindingEvaluatedAt.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditFindingEvaluatedAt = void 0;
+const DateTimeString_1 = require("../../../../shared/domain/value-objects/DateTimeString");
+/**
+ * The moment at which an audit finding changes (updated, answered, closed or reopened).
+ * The domain does not read the clock: the caller passes the current moment and this value
+ * object validates its format.
+ */
+class AuditFindingEvaluatedAt extends DateTimeString_1.DateTimeString {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, AuditFindingEvaluatedAt.PROPERTY_NAME);
+    }
+    static create(value) {
+        DateTimeString_1.DateTimeString.guardAgainstEmptyValue(value, AuditFindingEvaluatedAt.PROPERTY_NAME);
+        DateTimeString_1.DateTimeString.guardAgainstInvalidType(value, AuditFindingEvaluatedAt.PROPERTY_NAME);
+        DateTimeString_1.DateTimeString.guardAgainstInvalidDateTimeFormat(value);
+        return new AuditFindingEvaluatedAt(value, false);
+    }
+    static fromPrimitives(primitive) {
+        const value = primitive;
+        return new AuditFindingEvaluatedAt(value, true);
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.AuditFindingEvaluatedAt = AuditFindingEvaluatedAt;
+AuditFindingEvaluatedAt.PROPERTY_NAME = 'now';

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/value-objects/AuditFindingId.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditFindingId = void 0;
+const AggregateId_1 = require("../../../../shared/domain/value-objects/AggregateId");
+const SemanticUuidPrefix_1 = require("../../../../shared/domain/enums/SemanticUuidPrefix");
+const InvalidAggregatePrefixError_1 = require("../../../../shared/domain/exceptions/InvalidAggregatePrefixError");
+/**
+ * Identity of an AuditFinding aggregate (`CFA-FND_<id>`).
+ */
+class AuditFindingId extends AggregateId_1.AggregateId {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, AuditFindingId.PROPERTY_NAME);
+    }
+    static create(value) {
+        AggregateId_1.AggregateId.guardAgainstEmptyValue(value, AuditFindingId.PROPERTY_NAME);
+        AggregateId_1.AggregateId.guardAgainstInvalidType(value, AuditFindingId.PROPERTY_NAME);
+        AggregateId_1.AggregateId.guardAgainstInvalidId(value, AuditFindingId.PROPERTY_NAME);
+        // Validate that the prefix is valid for AuditFinding
+        AuditFindingId.guardAgainstInvalidPrefix(value);
+        return new AuditFindingId(value, false);
+    }
+    /**
+     * Validates that the id has the AuditFinding prefix.
+     * The id format was already validated, so the prefix can be extracted safely.
+     */
+    static guardAgainstInvalidPrefix(value) {
+        const prefix = new AuditFindingId(value, true).extractPrefix();
+        if (AuditFindingId.VALID_PREFIXES.includes(prefix) === false) {
+            throw InvalidAggregatePrefixError_1.InvalidAggregatePrefixError.create(value, 'AuditFinding', prefix, AuditFindingId.VALID_PREFIXES, AuditFindingId.PROPERTY_NAME);
+        }
+    }
+    static fromPrimitives(primitive) {
+        const value = primitive;
+        return new AuditFindingId(value, true);
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.AuditFindingId = AuditFindingId;
+AuditFindingId.PROPERTY_NAME = 'id';
+AuditFindingId.VALID_PREFIXES = [
+    SemanticUuidPrefix_1.SemanticUuidPrefix.CFA_AUDIT_FINDING,
+];

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/value-objects/AuditFindingOpenedAt.js

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

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/value-objects/AuditFindingOpenedByCarbonAuditorId.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditFindingOpenedByCarbonAuditorId = void 0;
+const UserId_1 = require("../../../../shared/domain/value-objects/UserId");
+const SemanticUuidPrefix_1 = require("../../../../shared/domain/enums/SemanticUuidPrefix");
+const InvalidUserPrefixError_1 = require("../../../../shared/domain/exceptions/InvalidUserPrefixError");
+/**
+ * Carbon auditor who raised an audit finding (`USR-STH-AUD_<id>`).
+ */
+class AuditFindingOpenedByCarbonAuditorId extends UserId_1.UserId {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation);
+    }
+    static create(value) {
+        UserId_1.UserId.guardAgainstEmptyValue(value, AuditFindingOpenedByCarbonAuditorId.OPENED_BY_PROPERTY_NAME);
+        UserId_1.UserId.guardAgainstInvalidType(value, AuditFindingOpenedByCarbonAuditorId.OPENED_BY_PROPERTY_NAME);
+        UserId_1.UserId.guardAgainstInvalidId(value, AuditFindingOpenedByCarbonAuditorId.OPENED_BY_PROPERTY_NAME);
+        // Validate that the prefix belongs to a carbon auditor
+        AuditFindingOpenedByCarbonAuditorId.guardAgainstInvalidCarbonAuditorPrefix(value);
+        return new AuditFindingOpenedByCarbonAuditorId(value, false);
+    }
+    /**
+     * Validates that the id has the carbon auditor prefix.
+     * The id format was already validated, so the prefix can be extracted safely.
+     */
+    static guardAgainstInvalidCarbonAuditorPrefix(value) {
+        const prefix = new AuditFindingOpenedByCarbonAuditorId(value, true).extractPrefix();
+        if (AuditFindingOpenedByCarbonAuditorId.VALID_PREFIXES.includes(prefix) === false) {
+            throw InvalidUserPrefixError_1.InvalidUserPrefixError.create(value, prefix, AuditFindingOpenedByCarbonAuditorId.VALID_PREFIXES);
+        }
+    }
+    static fromPrimitives(primitive) {
+        const value = primitive;
+        return new AuditFindingOpenedByCarbonAuditorId(value, true);
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.AuditFindingOpenedByCarbonAuditorId = AuditFindingOpenedByCarbonAuditorId;
+AuditFindingOpenedByCarbonAuditorId.OPENED_BY_PROPERTY_NAME = 'openedByCarbonAuditorId';
+AuditFindingOpenedByCarbonAuditorId.VALID_PREFIXES = [
+    SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_AUDITOR,
+];

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/value-objects/AuditFindingRespondedAt.js

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

package/build/carbonbox/carbon-footprint-audits/audit-findings/domain/value-objects/AuditFindingRespondedByStakeholder.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditFindingRespondedByStakeholder = void 0;
+const StakeholderReference_1 = require("../../../../shared/domain/value-objects/StakeholderReference");
+const StakeholderRole_1 = require("../../../../shared/domain/enums/StakeholderRole");
+const InvalidAuditFindingResponderError_1 = require("../exceptions/InvalidAuditFindingResponderError");
+/**
+ * Stakeholder who answered an audit finding (D11): the carbon client or whoever supervises it.
+ * An auditor never answers a finding.
+ */
+class AuditFindingRespondedByStakeholder extends StakeholderReference_1.StakeholderReference {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, AuditFindingRespondedByStakeholder.PROPERTY_NAME);
+        if (skipDomainValidation === false) {
+            AuditFindingRespondedByStakeholder.guardAgainstInvalidResponderRole(value.roleType);
+        }
+    }
+    static create(value) {
+        return new AuditFindingRespondedByStakeholder(value, false);
+    }
+    static fromPrimitives(primitives) {
+        const value = {
+            id: primitives.id,
+            displayName: primitives.displayName,
+            roleType: primitives.roleType,
+            taxIdentification: primitives.taxIdentification,
+        };
+        return new AuditFindingRespondedByStakeholder(value, true);
+    }
+    /**
+     * Validates that the stakeholder has a role of the carbon client side.
+     */
+    static guardAgainstInvalidResponderRole(roleType) {
+        if (!this.ALLOWED_RESPONDER_ROLES.includes(roleType)) {
+            throw InvalidAuditFindingResponderError_1.InvalidAuditFindingResponderError.create(roleType, this.ALLOWED_RESPONDER_ROLES);
+        }
+    }
+    toPrimitives() {
+        return {
+            id: this.id,
+            displayName: this.value.displayName,
+            roleType: this.value.roleType,
+            taxIdentification: this.value.taxIdentification,
+        };
+    }
+}
+exports.AuditFindingRespondedByStakeholder = AuditFindingRespondedByStakeholder;
+AuditFindingRespondedByStakeholder.PROPERTY_NAME = 'respondedByStakeholder';
+// Roles that prepare the carbon client data and therefore answer the findings
+AuditFindingRespondedByStakeholder.ALLOWED_RESPONDER_ROLES = [
+    StakeholderRole_1.StakeholderRole.CARBON_CLIENT,
+    StakeholderRole_1.StakeholderRole.CARBON_COORDINATOR,
+    StakeholderRole_1.StakeholderRole.CARBON_MANAGER,
+    StakeholderRole_1.StakeholderRole.CARBON_HOST,
+];