@carbonbox/domain 0.52.0 → 0.54.0

package/build/carbonbox/carbon-footprint-audits/verification-statements/domain/value-objects/VerificationStatementVerifierOrganizationName.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VerificationStatementVerifierOrganizationName = void 0;
+const String_1 = require("../../../../shared/domain/value-objects/String");
+const InvalidPropertyValueError_1 = require("../../../../shared/domain/exceptions/InvalidPropertyValueError");
+/**
+ * Name of the verification body the auditor issued the statement for, copied from the auditor
+ * profile when issuing (never re-read). Required, up to 255 characters.
+ */
+class VerificationStatementVerifierOrganizationName extends String_1.String {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, VerificationStatementVerifierOrganizationName.PROPERTY_NAME);
+    }
+    static create(value) {
+        String_1.String.guardAgainstEmptyValue(value, VerificationStatementVerifierOrganizationName.PROPERTY_NAME);
+        String_1.String.guardAgainstInvalidType(value, VerificationStatementVerifierOrganizationName.PROPERTY_NAME);
+        VerificationStatementVerifierOrganizationName.guardAgainstExcessiveLength(value);
+        return new VerificationStatementVerifierOrganizationName(value.trim(), false);
+    }
+    static guardAgainstExcessiveLength(value) {
+        if (value.trim().length > VerificationStatementVerifierOrganizationName.MAX_LENGTH) {
+            throw InvalidPropertyValueError_1.InvalidPropertyValueError.create(VerificationStatementVerifierOrganizationName.PROPERTY_NAME, `at most ${VerificationStatementVerifierOrganizationName.MAX_LENGTH} characters`, `${value.trim().length} characters`);
+        }
+    }
+    static fromPrimitives(primitive) {
+        const value = primitive;
+        return new VerificationStatementVerifierOrganizationName(value, true);
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.VerificationStatementVerifierOrganizationName = VerificationStatementVerifierOrganizationName;
+VerificationStatementVerifierOrganizationName.PROPERTY_NAME = 'verifierOrganizationName';
+VerificationStatementVerifierOrganizationName.MAX_LENGTH = 255;

package/build/carbonbox/emission-calculation-results/ghg-emission-results/domain/entity/GHGEmissionResult.js

@@ -14,6 +14,7 @@ var _GHGEmissionResult_emissionCalculation, _GHGEmissionResult_greenhouseGas, _G
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GHGEmissionResult = void 0;
 const AggregateRoot_1 = require("../../../../shared/domain/entities/AggregateRoot");
+const EmissionSource_1 = require("../../../../shared/domain/enums/EmissionSource");
 const GHGEmissionResultActivityValue_1 = require("../value-objects/GHGEmissionResultActivityValue");
 const GHGEmissionResultCo2Equivalent_1 = require("../value-objects/GHGEmissionResultCo2Equivalent");
 const GHGEmissionResultEmissionCalculation_1 = require("../value-objects/GHGEmissionResultEmissionCalculation");
@@ -120,11 +121,14 @@ class GHGEmissionResult extends AggregateRoot_1.AggregateRoot {
         return __classPrivateFieldGet(this, _GHGEmissionResult_unit, "f");
     }
     /**
-     * Si este resultado se suma al total del inventario. Falso solo para el CO₂ biogénico
-     * (`CO2-BIOGENIC`), que se reporta como partida informativa fuera de los alcances.
+     * Si este resultado se suma al total del inventario. Falso para el CO₂ biogénico
+     * (`CO2-BIOGENIC`, por su especie) y para todo lo que emite la fuente tierras forestales
+     * (`FOREST_LAND`): ambos se reportan como partidas informativas fuera de los alcances.
      */
     countsTowardsInventoryTotal() {
-        return __classPrivateFieldGet(this, _GHGEmissionResult_greenhouseGas, "f").countsTowardsInventoryTotal();
+        const gasCountsTowardsTotal = __classPrivateFieldGet(this, _GHGEmissionResult_greenhouseGas, "f").countsTowardsInventoryTotal();
+        const comesFromForestLand = __classPrivateFieldGet(this, _GHGEmissionResult_emissionCalculation, "f").emissionSource === EmissionSource_1.EmissionSource.FOREST_LAND;
+        return gasCountsTowardsTotal && !comesFromForestLand;
     }
 }
 exports.GHGEmissionResult = GHGEmissionResult;

package/build/carbonbox/reporting/shared/domain/exceptions/InvalidReportAssuranceError.js

@@ -12,8 +12,9 @@ class InvalidReportAssuranceError extends CodedRootError_1.CodedRootError {
         };
         const suggestions = [
             'level must be a value of AssuranceLevel (NONE, LIMITED, REASONABLE)',
-            'With level NONE, verificationType and verifierName must be null',
+            'With level NONE, verificationType, verifierName and verificationStatementId must be null',
             'With level LIMITED or REASONABLE, verificationType must be a value of VerificationType and verifierName a non-empty name',
+            'verificationStatementId only backs a THIRD_PARTY verification',
             'Review the assurance declaration of the report instance',
         ];
         super(ErrorCode_1.ErrorCode.INVALID_REPORT_ASSURANCE, technicalMessage, context, suggestions);

package/build/carbonbox/reporting/shared/domain/value-objects/ReportAssurance.js

@@ -5,10 +5,12 @@ const ValueObject_1 = require("../../../../shared/domain/value-objects/ValueObje
 const AssuranceLevel_1 = require("../enums/AssuranceLevel");
 const VerificationType_1 = require("../enums/VerificationType");
 const InvalidReportAssuranceError_1 = require("../exceptions/InvalidReportAssuranceError");
+const VerificationStatementId_1 = require("../../../../carbon-footprint-audits/verification-statements/domain/value-objects/VerificationStatementId");
 /**
  * Assurance declaration of a report instance (GAP 6, ISO 14064-1 §9.3.1 / ISO 14064-3).
  * Invariants: with level NONE nothing else is declared; with LIMITED or REASONABLE the
- * verification type and the verifier name are mandatory.
+ * verification type and the verifier name are mandatory; a verification statement of the platform
+ * (AUD-D11) only backs a THIRD_PARTY verification.
  */
 class ReportAssurance extends ValueObject_1.ValueObject {
     constructor(value, skipDomainValidation) {
@@ -24,7 +26,12 @@ class ReportAssurance extends ValueObject_1.ValueObject {
         return new ReportAssurance(primitives, true);
     }
     static notVerified() {
-        return new ReportAssurance({ level: AssuranceLevel_1.AssuranceLevel.NONE, verificationType: null, verifierName: null }, false);
+        return new ReportAssurance({
+            level: AssuranceLevel_1.AssuranceLevel.NONE,
+            verificationType: null,
+            verifierName: null,
+            verificationStatementId: null,
+        }, false);
     }
     validateReportAssurance(value) {
         if (!Object.values(AssuranceLevel_1.AssuranceLevel).includes(value.level)) {
@@ -37,6 +44,9 @@ class ReportAssurance extends ValueObject_1.ValueObject {
             if (value.verifierName !== null) {
                 throw InvalidReportAssuranceError_1.InvalidReportAssuranceError.create('verifierName must be null when the inventory is not verified (level NONE)');
             }
+            if (value.verificationStatementId !== null) {
+                throw InvalidReportAssuranceError_1.InvalidReportAssuranceError.create('verificationStatementId must be null when the inventory is not verified (level NONE)');
+            }
             return;
         }
         if (value.verificationType === null || !Object.values(VerificationType_1.VerificationType).includes(value.verificationType)) {
@@ -48,6 +58,12 @@ class ReportAssurance extends ValueObject_1.ValueObject {
         if (value.verifierName.trim().length > ReportAssurance.VERIFIER_NAME_MAX_LENGTH) {
             throw InvalidReportAssuranceError_1.InvalidReportAssuranceError.create(`verifierName cannot exceed ${ReportAssurance.VERIFIER_NAME_MAX_LENGTH} characters`);
         }
+        if (value.verificationStatementId !== null) {
+            if (value.verificationType !== VerificationType_1.VerificationType.THIRD_PARTY) {
+                throw InvalidReportAssuranceError_1.InvalidReportAssuranceError.create('verificationStatementId can only back a THIRD_PARTY verification');
+            }
+            VerificationStatementId_1.VerificationStatementId.create(value.verificationStatementId);
+        }
     }
     getLevel() {
         return this.value.level;
@@ -64,11 +80,21 @@ class ReportAssurance extends ValueObject_1.ValueObject {
     isIndependentlyVerified() {
         return this.value.verificationType === VerificationType_1.VerificationType.THIRD_PARTY;
     }
+    getVerificationStatementId() {
+        return this.value.verificationStatementId;
+    }
+    /**
+     * Whether the assurance is backed by a verification statement issued in the platform (AUD-D11).
+     */
+    isBackedByVerificationStatement() {
+        return this.value.verificationStatementId !== null;
+    }
     toPrimitives() {
         return {
             level: this.value.level,
             verificationType: this.value.verificationType,
             verifierName: this.value.verifierName === null ? null : this.value.verifierName.trim(),
+            verificationStatementId: this.value.verificationStatementId,
         };
     }
 }

package/build/carbonbox/shared/domain/authorization/enums/Permission.js

@@ -37,6 +37,10 @@ var Permission;
     Permission["STAKEHOLDERS_ACTIVATE_CARBON_CLIENT_ACCOUNT"] = "STAKEHOLDERS_ACTIVATE_CARBON_CLIENT_ACCOUNT";
     Permission["STAKEHOLDERS_DEACTIVATE_CARBON_CLIENT_ACCOUNT"] = "STAKEHOLDERS_DEACTIVATE_CARBON_CLIENT_ACCOUNT";
     Permission["STAKEHOLDERS_VIEW_CARBON_CLIENT_LIST"] = "STAKEHOLDERS_VIEW_CARBON_CLIENT_LIST";
+    Permission["STAKEHOLDERS_VIEW_CARBON_AUDITOR_PROFILE"] = "STAKEHOLDERS_VIEW_CARBON_AUDITOR_PROFILE";
+    Permission["STAKEHOLDERS_VIEW_CARBON_AUDITOR_LIST"] = "STAKEHOLDERS_VIEW_CARBON_AUDITOR_LIST";
+    Permission["STAKEHOLDERS_ACTIVATE_CARBON_AUDITOR_ACCOUNT"] = "STAKEHOLDERS_ACTIVATE_CARBON_AUDITOR_ACCOUNT";
+    Permission["STAKEHOLDERS_DEACTIVATE_CARBON_AUDITOR_ACCOUNT"] = "STAKEHOLDERS_DEACTIVATE_CARBON_AUDITOR_ACCOUNT";
     Permission["USER_PROFILE_VIEW_OWN_PROFILE"] = "USER_PROFILE_VIEW_OWN_PROFILE";
     Permission["USER_PROFILE_UPDATE_OWN_PROFILE"] = "USER_PROFILE_UPDATE_OWN_PROFILE";
     Permission["USER_PROFILE_CHANGE_OWN_PASSWORD"] = "USER_PROFILE_CHANGE_OWN_PASSWORD";
@@ -278,4 +282,24 @@ var Permission;
     Permission["REPORTING_MANAGE_REPORT_PREPARATION_QUESTIONNAIRE_CUSTOM_QUESTIONS"] = "REPORTING_MANAGE_REPORT_PREPARATION_QUESTIONNAIRE_CUSTOM_QUESTIONS";
     Permission["REPORTING_VIEW_REPORT_PREPARATION_QUESTIONNAIRE"] = "REPORTING_VIEW_REPORT_PREPARATION_QUESTIONNAIRE";
     Permission["REPORTING_VIEW_REPORT_PREPARATION_QUESTIONNAIRE_LIST"] = "REPORTING_VIEW_REPORT_PREPARATION_QUESTIONNAIRE_LIST";
+    // Carbon Footprint Audits (AUD-D07)
+    Permission["CARBON_FOOTPRINT_AUDITS_ASSIGN_AUDITOR"] = "CARBON_FOOTPRINT_AUDITS_ASSIGN_AUDITOR";
+    Permission["CARBON_FOOTPRINT_AUDITS_REPLACE_AUDITOR"] = "CARBON_FOOTPRINT_AUDITS_REPLACE_AUDITOR";
+    Permission["CARBON_FOOTPRINT_AUDITS_REVOKE_AUDIT_ENGAGEMENT"] = "CARBON_FOOTPRINT_AUDITS_REVOKE_AUDIT_ENGAGEMENT";
+    Permission["CARBON_FOOTPRINT_AUDITS_RESEND_AUDITOR_INVITATION"] = "CARBON_FOOTPRINT_AUDITS_RESEND_AUDITOR_INVITATION";
+    Permission["CARBON_FOOTPRINT_AUDITS_UPDATE_AUDITED_CARBON_FOOTPRINTS"] = "CARBON_FOOTPRINT_AUDITS_UPDATE_AUDITED_CARBON_FOOTPRINTS";
+    Permission["CARBON_FOOTPRINT_AUDITS_VIEW_AUDIT_ENGAGEMENT"] = "CARBON_FOOTPRINT_AUDITS_VIEW_AUDIT_ENGAGEMENT";
+    Permission["CARBON_FOOTPRINT_AUDITS_VIEW_AUDIT_ENGAGEMENT_LIST"] = "CARBON_FOOTPRINT_AUDITS_VIEW_AUDIT_ENGAGEMENT_LIST";
+    Permission["CARBON_FOOTPRINT_AUDITS_ACCEPT_AUDIT_ENGAGEMENT"] = "CARBON_FOOTPRINT_AUDITS_ACCEPT_AUDIT_ENGAGEMENT";
+    Permission["CARBON_FOOTPRINT_AUDITS_DECLINE_AUDIT_ENGAGEMENT"] = "CARBON_FOOTPRINT_AUDITS_DECLINE_AUDIT_ENGAGEMENT";
+    Permission["CARBON_FOOTPRINT_AUDITS_CREATE_AUDIT_FINDING"] = "CARBON_FOOTPRINT_AUDITS_CREATE_AUDIT_FINDING";
+    Permission["CARBON_FOOTPRINT_AUDITS_UPDATE_AUDIT_FINDING"] = "CARBON_FOOTPRINT_AUDITS_UPDATE_AUDIT_FINDING";
+    Permission["CARBON_FOOTPRINT_AUDITS_CLOSE_AUDIT_FINDING"] = "CARBON_FOOTPRINT_AUDITS_CLOSE_AUDIT_FINDING";
+    Permission["CARBON_FOOTPRINT_AUDITS_REOPEN_AUDIT_FINDING"] = "CARBON_FOOTPRINT_AUDITS_REOPEN_AUDIT_FINDING";
+    Permission["CARBON_FOOTPRINT_AUDITS_RESPOND_TO_AUDIT_FINDING"] = "CARBON_FOOTPRINT_AUDITS_RESPOND_TO_AUDIT_FINDING";
+    Permission["CARBON_FOOTPRINT_AUDITS_VIEW_AUDIT_FINDING"] = "CARBON_FOOTPRINT_AUDITS_VIEW_AUDIT_FINDING";
+    Permission["CARBON_FOOTPRINT_AUDITS_VIEW_AUDIT_FINDING_LIST"] = "CARBON_FOOTPRINT_AUDITS_VIEW_AUDIT_FINDING_LIST";
+    Permission["CARBON_FOOTPRINT_AUDITS_ISSUE_VERIFICATION_STATEMENT"] = "CARBON_FOOTPRINT_AUDITS_ISSUE_VERIFICATION_STATEMENT";
+    Permission["CARBON_FOOTPRINT_AUDITS_VIEW_VERIFICATION_STATEMENT"] = "CARBON_FOOTPRINT_AUDITS_VIEW_VERIFICATION_STATEMENT";
+    Permission["CARBON_FOOTPRINT_AUDITS_VIEW_VERIFICATION_STATEMENT_LIST"] = "CARBON_FOOTPRINT_AUDITS_VIEW_VERIFICATION_STATEMENT_LIST";
 })(Permission || (exports.Permission = Permission = {}));

package/build/carbonbox/shared/domain/enums/EmissionSource.js

@@ -30,6 +30,8 @@ var EmissionSource;
     EmissionSource["RESIDENTIAL_BUILDINGS"] = "RESIDENTIAL_BUILDINGS";
     EmissionSource["COMMERCIAL_BUILDINGS"] = "COMMERCIAL_BUILDINGS";
     EmissionSource["INSTITUTIONAL_BUILDINGS"] = "INSTITUTIONAL_BUILDINGS";
+    // LAND USE sources
+    EmissionSource["FOREST_LAND"] = "FOREST_LAND";
     // OTHER sources
     EmissionSource["OTHER_SOURCES"] = "OTHER_SOURCES";
 })(EmissionSource || (exports.EmissionSource = EmissionSource = {}));

package/build/carbonbox/shared/domain/enums/ErrorCode.js

@@ -15,6 +15,7 @@ exports.ErrorCode = void 0;
  * - EMC: Emission Calculations
  * - ECR: Emission Calculation Results
  * - RPT: Reporting
+ * - AUD: Carbon Footprint Audits
  * - SHR: Shared/Common
  *
  * Total Codes: 182
@@ -179,6 +180,24 @@ var ErrorCode;
     ErrorCode["INVALID_REPORT_BLOCK_DATA_BINDING"] = "CBX-RPT-027";
     ErrorCode["INVALID_REPORT_ASSURANCE"] = "CBX-RPT-028";
     ErrorCode["REPORT_CONTENT_GENERATION_JOB_INVALID_STATUS_TRANSITION"] = "CBX-RPT-029";
+    // Carbon Footprint Audits Errors (CBX-AUD-XXX) — AUD-D08
+    // Audit engagements (CBX-AUD-001 to CBX-AUD-005)
+    ErrorCode["INVALID_AUDIT_ENGAGEMENT_STATUS"] = "CBX-AUD-001";
+    ErrorCode["AUDIT_ENGAGEMENT_INVALID_STATUS_TRANSITION"] = "CBX-AUD-002";
+    ErrorCode["AUDIT_ENGAGEMENT_NOT_ACTIVE"] = "CBX-AUD-003";
+    ErrorCode["AUDIT_ENGAGEMENT_NOT_ASSIGNED_TO_CARBON_AUDITOR"] = "CBX-AUD-004";
+    ErrorCode["INVALID_AUDITED_CARBON_FOOTPRINT_CONFIGURATIONS"] = "CBX-AUD-005";
+    // Audit findings (CBX-AUD-006 to CBX-AUD-010)
+    ErrorCode["INVALID_AUDIT_FINDING_TYPE"] = "CBX-AUD-006";
+    ErrorCode["INVALID_AUDIT_FINDING_STATUS"] = "CBX-AUD-007";
+    ErrorCode["INVALID_AUDIT_FINDING_SUBJECT"] = "CBX-AUD-008";
+    ErrorCode["AUDIT_FINDING_INVALID_STATUS_TRANSITION"] = "CBX-AUD-009";
+    ErrorCode["INVALID_AUDIT_FINDING_RESPONDER"] = "CBX-AUD-010";
+    // Verification statements (CBX-AUD-011 to CBX-AUD-014)
+    ErrorCode["INVALID_VERIFICATION_OPINION"] = "CBX-AUD-011";
+    ErrorCode["INVALID_VERIFICATION_STANDARD"] = "CBX-AUD-012";
+    ErrorCode["INVALID_VERIFICATION_ASSURANCE_LEVEL"] = "CBX-AUD-013";
+    ErrorCode["VERIFICATION_STATEMENT_BLOCKED_BY_UNRESOLVED_FINDINGS"] = "CBX-AUD-014";
     // Shared/Common Errors (CBX-SHR-XXX)
     ErrorCode["INVALID_EMAIL"] = "CBX-SHR-001";
     ErrorCode["INVALID_DATE_FORMAT"] = "CBX-SHR-002";
@@ -264,4 +283,6 @@ var ErrorCode;
     ErrorCode["INVALID_FULL_INTERNATIONAL_NUMBER"] = "CBX-SHR-075";
     // Tenant Isolation Errors (CBX-SHR-076) — AIS-D02/AIS-D03
     ErrorCode["INVALID_CROSS_TENANT_REFERENCE"] = "CBX-SHR-076";
+    // Verification body accreditation (CBX-SHR-077) — AUD-D02/AUD-D06
+    ErrorCode["INVALID_ACCREDITATION"] = "CBX-SHR-077";
 })(ErrorCode || (exports.ErrorCode = ErrorCode = {}));

package/build/carbonbox/shared/domain/enums/SemanticUuidPrefix.js

@@ -68,6 +68,7 @@ var SemanticUuidPrefix;
     SemanticUuidPrefix["USR_STH_COORDINATOR"] = "USR-STH-CRD";
     SemanticUuidPrefix["USR_STH_HOST"] = "USR-STH-CHO";
     SemanticUuidPrefix["USR_STH_MANAGER"] = "USR-STH-MGR";
+    SemanticUuidPrefix["USR_STH_AUDITOR"] = "USR-STH-AUD";
     // Users - Invitations (AIS-D04)
     SemanticUuidPrefix["USR_INVITATION"] = "USR-INV";
     // Purchase Management System
@@ -88,6 +89,10 @@ var SemanticUuidPrefix;
     SemanticUuidPrefix["RPT_PREPARATION_QUESTIONNAIRE"] = "RPT-PRE";
     SemanticUuidPrefix["RPT_PREPARATION_QUESTION"] = "RPT-PRE-QST";
     SemanticUuidPrefix["RPT_CONTENT_GENERATION_JOB"] = "RPT-CGJ";
+    // Carbon Footprint Audits (AUD-D05, AUD-D06)
+    SemanticUuidPrefix["CFA_AUDIT_ENGAGEMENT"] = "CFA-ENG";
+    SemanticUuidPrefix["CFA_AUDIT_FINDING"] = "CFA-FND";
+    SemanticUuidPrefix["CFA_VERIFICATION_STATEMENT"] = "CFA-VST";
     // Future expansion examples (when system grows):
     // ADC_SUB_FIELDS = 'ADC-SUB-FLD', // Activity Data Collection -> Submissions -> Fields
     // USR_STH_CHO_MGT = 'USR-STH-CHO-MGT', // Users -> Stakeholders -> Carbon Host -> Management

package/build/carbonbox/shared/domain/enums/StakeholderRole.js

@@ -7,4 +7,6 @@ var StakeholderRole;
     StakeholderRole["CARBON_MANAGER"] = "CARBON_MANAGER";
     StakeholderRole["CARBON_COORDINATOR"] = "CARBON_COORDINATOR";
     StakeholderRole["CARBON_CLIENT"] = "CARBON_CLIENT";
+    // AUD-D01: external verifier of 1..N carbon clients; outside the supervision chain
+    StakeholderRole["CARBON_AUDITOR"] = "CARBON_AUDITOR";
 })(StakeholderRole || (exports.StakeholderRole = StakeholderRole = {}));

package/build/carbonbox/shared/domain/exceptions/InvalidAccreditationError.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidAccreditationError = void 0;
+const CodedRootError_1 = require("./CodedRootError");
+const ErrorCode_1 = require("../enums/ErrorCode");
+/**
+ * The accreditation of a verification body is incomplete or too long (AUD-D02, AUD-D06).
+ */
+class InvalidAccreditationError extends CodedRootError_1.CodedRootError {
+    constructor(propertyName, reason) {
+        const technicalMessage = `Invalid accreditation '${propertyName}': ${reason}`;
+        const context = {
+            propertyName,
+            reason,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'Send both the accreditation body and the accreditation number, or null when the verifier is not accredited',
+            'The accreditation body and number cannot be empty nor exceed 255 characters',
+        ];
+        super(ErrorCode_1.ErrorCode.INVALID_ACCREDITATION, technicalMessage, context, suggestions);
+        this.name = 'InvalidAccreditationError';
+    }
+    static create(propertyName, reason) {
+        return new InvalidAccreditationError(propertyName, reason);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.InvalidAccreditationError = InvalidAccreditationError;

package/build/carbonbox/shared/domain/journeys/enums/CarbonClientJourneyBlockingReason.js

@@ -43,7 +43,7 @@ var CarbonClientJourneyBlockingReason;
      * The carbon client has facilities but none (or more than one) is marked as primary
      */
     CarbonClientJourneyBlockingReason["NO_PRIMARY_FACILITY"] = "NO_PRIMARY_FACILITY";
-    // Steps 3 to 10 - Carbon footprint configuration
+    // Steps 3 to 11 - Carbon footprint configuration
     /**
      * The carbon client has no carbon footprint configuration for an entitled footprint type
      */
@@ -82,7 +82,24 @@ var CarbonClientJourneyBlockingReason;
      * The calculation workflow exists but the caller is not one of its allowed executors
      */
     CarbonClientJourneyBlockingReason["CALLER_NOT_ALLOWED_EXECUTOR"] = "CALLER_NOT_ALLOWED_EXECUTOR";
-    // Step 9 - Report
+    // Step 8 - Verification (AUD-B27)
+    /**
+     * The auditor service is in force but no auditor was assigned to the footprint
+     */
+    CarbonClientJourneyBlockingReason["NO_AUDITOR_ASSIGNED"] = "NO_AUDITOR_ASSIGNED";
+    /**
+     * The audit engagement is waiting for the auditor to accept it
+     */
+    CarbonClientJourneyBlockingReason["AUDIT_ENGAGEMENT_PENDING_ACCEPTANCE"] = "AUDIT_ENGAGEMENT_PENDING_ACCEPTANCE";
+    /**
+     * Audit findings of the footprint are waiting for an answer of the carbon client side
+     */
+    CarbonClientJourneyBlockingReason["AUDIT_FINDINGS_AWAITING_RESPONSE"] = "AUDIT_FINDINGS_AWAITING_RESPONSE";
+    /**
+     * The audit engagement is active but the auditor has not issued the verification statement yet
+     */
+    CarbonClientJourneyBlockingReason["VERIFICATION_STATEMENT_NOT_ISSUED"] = "VERIFICATION_STATEMENT_NOT_ISSUED";
+    // Step 10 - Report
     /**
      * The report is waiting for the internal approval
      */
@@ -91,7 +108,7 @@ var CarbonClientJourneyBlockingReason;
      * The report is waiting for the carbon client approval
      */
     CarbonClientJourneyBlockingReason["REPORT_AWAITING_CLIENT_APPROVAL"] = "REPORT_AWAITING_CLIENT_APPROVAL";
-    // Step 10 - Completion
+    // Step 11 - Completion
     /**
      * The ACTIVE carbon footprint configuration does not meet its completion requirements
      */

package/build/carbonbox/shared/domain/journeys/enums/CarbonClientJourneyStep.js

@@ -38,15 +38,20 @@ var CarbonClientJourneyStep;
      */
     CarbonClientJourneyStep["FOOTPRINT_CALCULATED"] = "FOOTPRINT_CALCULATED";
     /**
-     * Step 8 - The report preparation questionnaire for the footprint type is COMPLETED
+     * Step 8 (optional, AUD-B27) - A carbon auditor issued the verification statement of the footprint.
+     * NOT_APPLICABLE when the carbon client has not purchased the auditor service
+     */
+    CarbonClientJourneyStep["VERIFICATION"] = "VERIFICATION";
+    /**
+     * Step 9 - The report preparation questionnaire for the footprint type is COMPLETED
      */
     CarbonClientJourneyStep["REPORT_QUESTIONNAIRE_COMPLETED"] = "REPORT_QUESTIONNAIRE_COMPLETED";
     /**
-     * Step 9 - The report for the footprint type (and period, for corporate footprints) is PUBLISHED
+     * Step 10 - The report for the footprint type (and period, for corporate footprints) is PUBLISHED
      */
     CarbonClientJourneyStep["REPORT_PUBLISHED"] = "REPORT_PUBLISHED";
     /**
-     * Step 10 - The carbon footprint configuration is COMPLETED
+     * Step 11 - The carbon footprint configuration is COMPLETED
      */
     CarbonClientJourneyStep["FOOTPRINT_COMPLETED"] = "FOOTPRINT_COMPLETED";
 })(CarbonClientJourneyStep || (exports.CarbonClientJourneyStep = CarbonClientJourneyStep = {}));

package/build/carbonbox/shared/domain/journeys/enums/PendingActionType.js

@@ -56,4 +56,12 @@ var PendingActionType;
      * Carbon clients with an ACTIVE carbon footprint configuration of a type that has no ACTIVE calculation workflow
      */
     PendingActionType["CARBON_CLIENTS_WITHOUT_ACTIVE_CALCULATION_WORKFLOW"] = "CARBON_CLIENTS_WITHOUT_ACTIVE_CALCULATION_WORKFLOW";
+    /**
+     * Audit findings in OPEN status, waiting for an answer of the carbon client side (AUD-B27)
+     */
+    PendingActionType["AUDIT_FINDINGS_TO_RESPOND"] = "AUDIT_FINDINGS_TO_RESPOND";
+    /**
+     * Audit engagements in PENDING_ACCEPTANCE status, waiting for the auditor to accept or decline them (AUD-B27)
+     */
+    PendingActionType["AUDIT_ENGAGEMENTS_TO_ACCEPT"] = "AUDIT_ENGAGEMENTS_TO_ACCEPT";
 })(PendingActionType || (exports.PendingActionType = PendingActionType = {}));

package/build/carbonbox/shared/domain/services/implementations/AggregateIdDomainService.js

@@ -84,6 +84,7 @@ class AggregateIdDomainService {
                 [SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_COORDINATOR]: 'User Stakeholder Coordinator',
                 [SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_HOST]: 'User Stakeholder Carbon Host',
                 [SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_MANAGER]: 'User Stakeholder Manager',
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_AUDITOR]: 'User Stakeholder Auditor',
                 // Shared Domain
                 [SemanticUuidPrefix_1.SemanticUuidPrefix.SHR_DOMAIN]: 'Shared Domain',
                 [SemanticUuidPrefix_1.SemanticUuidPrefix.SHR_EITHER]: 'Shared Either',
@@ -163,6 +164,7 @@ class AggregateIdDomainService {
                 'User Stakeholder Coordinator': [SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_COORDINATOR],
                 'User Stakeholder Carbon Host': [SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_HOST],
                 'User Stakeholder Manager': [SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_MANAGER],
+                'User Stakeholder Auditor': [SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_AUDITOR],
                 'Shared Domain': [SemanticUuidPrefix_1.SemanticUuidPrefix.SHR_DOMAIN],
                 'Shared Either': [SemanticUuidPrefix_1.SemanticUuidPrefix.SHR_EITHER],
             };

package/build/carbonbox/shared/domain/services/implementations/UserCreationDomainService.js

@@ -16,6 +16,7 @@ const CarbonClient_1 = require("../../../../stakeholders/carbon-clients/domain/e
 const CarbonCoordinator_1 = require("../../../../stakeholders/carbon-coordinators/domain/entity/CarbonCoordinator");
 const CarbonHost_1 = require("../../../../stakeholders/carbon-host/domain/entity/CarbonHost");
 const CarbonManager_1 = require("../../../../stakeholders/carbon-managers/domain/entity/CarbonManager");
+const CarbonAuditor_1 = require("../../../../stakeholders/carbon-auditors/domain/entity/CarbonAuditor");
 /**
  * Domain Service for User creation business logic.
  * Encapsulates the complex logic of determining which concrete User implementation to create
@@ -124,6 +125,8 @@ _UserCreationDomainService_instances = new WeakSet(), _UserCreationDomainService
             return CarbonCoordinator_1.CarbonCoordinator.fromPrimitives(primitives);
         case StakeholderRole_1.StakeholderRole.CARBON_CLIENT:
             return CarbonClient_1.CarbonClient.fromPrimitives(primitives);
+        case StakeholderRole_1.StakeholderRole.CARBON_AUDITOR:
+            return CarbonAuditor_1.CarbonAuditor.fromPrimitives(primitives);
         default:
             throw UnsupportedStakeholderRoleError_1.UnsupportedStakeholderRoleError.create(primitives.roleType);
     }
@@ -137,6 +140,8 @@ _UserCreationDomainService_instances = new WeakSet(), _UserCreationDomainService
             return CarbonCoordinator_1.CarbonCoordinator.create(props);
         case StakeholderRole_1.StakeholderRole.CARBON_CLIENT:
             return CarbonClient_1.CarbonClient.create(props);
+        case StakeholderRole_1.StakeholderRole.CARBON_AUDITOR:
+            return CarbonAuditor_1.CarbonAuditor.create(props);
         default:
             throw UnsupportedStakeholderRoleError_1.UnsupportedStakeholderRoleError.create(props.roleType);
     }
@@ -151,5 +156,6 @@ _UserCreationDomainService_instances = new WeakSet(), _UserCreationDomainService
         StakeholderRole_1.StakeholderRole.CARBON_MANAGER,
         StakeholderRole_1.StakeholderRole.CARBON_COORDINATOR,
         StakeholderRole_1.StakeholderRole.CARBON_CLIENT,
+        StakeholderRole_1.StakeholderRole.CARBON_AUDITOR,
     ];
 };

package/build/carbonbox/shared/domain/types/AccreditationPrimitives.js

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

package/build/carbonbox/shared/domain/value-objects/NullableAccreditation.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NullableAccreditation = void 0;
+const InvalidAccreditationError_1 = require("../exceptions/InvalidAccreditationError");
+const ValueObject_1 = require("./ValueObject");
+/**
+ * Accreditation of a verification body, or null when the verifier is not accredited
+ * (AUD-D02, AUD-D06). Base of the per-aggregate value objects (`CarbonAuditorAccreditation`,
+ * `VerificationStatementAccreditation`), like `NullableStakeholderReference`.
+ *
+ * Invariants: both fields are present and non-empty (trimmed), each up to 255 characters.
+ */
+class NullableAccreditation extends ValueObject_1.ValueObject {
+    constructor(value, skipDomainValidation, propertyName) {
+        super(value, skipDomainValidation, propertyName, 'AccreditationPrimitives or null', { allowNull: true, allowUndefined: false });
+        if (skipDomainValidation === false && value !== null) {
+            NullableAccreditation.guardAgainstInvalidField(value.accreditationBody, `${propertyName}.accreditationBody`);
+            NullableAccreditation.guardAgainstInvalidField(value.accreditationNumber, `${propertyName}.accreditationNumber`);
+        }
+    }
+    static guardAgainstInvalidField(field, propertyName) {
+        if (typeof field !== 'string' || field.trim() === '') {
+            throw InvalidAccreditationError_1.InvalidAccreditationError.create(propertyName, 'it is required and cannot be empty');
+        }
+        if (field.trim().length > NullableAccreditation.FIELD_MAX_LENGTH) {
+            throw InvalidAccreditationError_1.InvalidAccreditationError.create(propertyName, `it cannot exceed ${NullableAccreditation.FIELD_MAX_LENGTH} characters`);
+        }
+    }
+    hasValue() {
+        return this.value !== null;
+    }
+    toPrimitives() {
+        return this.value === null
+            ? null
+            : { accreditationBody: this.value.accreditationBody.trim(), accreditationNumber: this.value.accreditationNumber.trim() };
+    }
+}
+exports.NullableAccreditation = NullableAccreditation;
+NullableAccreditation.FIELD_MAX_LENGTH = 255;

package/build/carbonbox/shared/domain/value-objects/NullableStakeholderReference.js

@@ -84,6 +84,9 @@ class NullableStakeholderReference extends ValueObject_1.ValueObject {
     isCarbonClient() {
         return this.hasRole(StakeholderRole_1.StakeholderRole.CARBON_CLIENT);
     }
+    isCarbonAuditor() {
+        return this.hasRole(StakeholderRole_1.StakeholderRole.CARBON_AUDITOR);
+    }
     hasManagementRole() {
         return this.isCarbonManager() || this.isCarbonCoordinator();
     }

package/build/carbonbox/shared/domain/value-objects/StakeholderReference.js

@@ -194,6 +194,12 @@ class StakeholderReference extends ObjectValueObject_1.ObjectValueObject {
     isCarbonClient() {
         return this.hasRole(StakeholderRole_1.StakeholderRole.CARBON_CLIENT);
     }
+    /**
+     * Verifica si el stakeholder es un auditor de carbono (AUD-D01).
+     */
+    isCarbonAuditor() {
+        return this.hasRole(StakeholderRole_1.StakeholderRole.CARBON_AUDITOR);
+    }
     /**
      * Verifica si el stakeholder tiene roles de gestión.
      */

package/build/carbonbox/shared/domain/value-objects/UserId.js

@@ -77,6 +77,7 @@ class UserId extends AggregateId_1.AggregateId {
                 SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_COORDINATOR,
                 SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_HOST,
                 SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_MANAGER,
+                SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_AUDITOR,
             ].includes(prefix);
         }
         catch {
@@ -118,6 +119,14 @@ class UserId extends AggregateId_1.AggregateId {
             return false;
         }
     }
+    isStakeholderCarbonAuditor() {
+        try {
+            return this.extractPrefix() === SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_AUDITOR;
+        }
+        catch {
+            return false;
+        }
+    }
     /**
      * Gets the stakeholder role type from the semantic UUID prefix
      */
@@ -129,6 +138,7 @@ class UserId extends AggregateId_1.AggregateId {
                 [SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_COORDINATOR]: StakeholderRole_1.StakeholderRole.CARBON_COORDINATOR,
                 [SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_MANAGER]: StakeholderRole_1.StakeholderRole.CARBON_MANAGER,
                 [SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_HOST]: StakeholderRole_1.StakeholderRole.CARBON_HOST,
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_AUDITOR]: StakeholderRole_1.StakeholderRole.CARBON_AUDITOR,
             };
             return roleMap[prefix] || 'UNKNOWN';
         }
@@ -148,4 +158,5 @@ UserId.VALID_USER_PREFIXES = [
     SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_COORDINATOR,
     SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_HOST,
     SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_MANAGER,
+    SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_AUDITOR,
 ];