@carbonbox/domain 0.43.0 → 0.45.0

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

@@ -119,6 +119,13 @@ class GHGEmissionResult extends AggregateRoot_1.AggregateRoot {
     get unit() {
         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.
+     */
+    countsTowardsInventoryTotal() {
+        return __classPrivateFieldGet(this, _GHGEmissionResult_greenhouseGas, "f").countsTowardsInventoryTotal();
+    }
 }
 exports.GHGEmissionResult = GHGEmissionResult;
 _GHGEmissionResult_emissionCalculation = new WeakMap(), _GHGEmissionResult_greenhouseGas = new WeakMap(), _GHGEmissionResult_activityValue = new WeakMap(), _GHGEmissionResult_emissionFactor = new WeakMap(), _GHGEmissionResult_globalWarmingPotential = new WeakMap(), _GHGEmissionResult_rawEmission = new WeakMap(), _GHGEmissionResult_co2Equivalent = new WeakMap(), _GHGEmissionResult_unit = new WeakMap();

package/build/carbonbox/emission-calculation-results/ghg-emission-results/domain/value-objects/GHGEmissionResultGreenhouseGas.js

@@ -45,6 +45,18 @@ class GHGEmissionResultGreenhouseGas extends ValueObject_1.ValueObject {
     isFluorinatedGas() {
         return GHGEmissionResultGreenhouseGas.FLUORINATED_CATEGORIES.includes(this.category);
     }
+    /** CO₂ de biomasa / biocombustibles (`CO2-BIOGENIC`): partida informativa fuera del total. */
+    isBiogenicCarbonDioxide() {
+        return GreenhouseGasSpecies_1.GreenhouseGasSpecies.isBiogenicCarbonDioxide(this.species);
+    }
+    /**
+     * Si el resultado de este gas se suma al total del inventario y a sus alcances. Solo el CO₂
+     * biogénico queda fuera (GHG Protocol cap. 9 / ISO 14064-1 §9.3.1); el CH₄ y el N₂O de la
+     * misma combustión cuentan con su PCG.
+     */
+    countsTowardsInventoryTotal() {
+        return !this.isBiogenicCarbonDioxide();
+    }
     toPrimitives() {
         return {
             greenhouseGasCategory: this.value.greenhouseGasCategory,

package/build/carbonbox/reporting/report-content-generation-jobs/domain/entity/IReportContentGenerationJob.js

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

package/build/carbonbox/reporting/report-content-generation-jobs/domain/entity/ReportContentGenerationJob.js

@@ -0,0 +1,158 @@
+"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 _ReportContentGenerationJob_reportInstanceId, _ReportContentGenerationJob_carbonClientId, _ReportContentGenerationJob_requestedByStakeholderId, _ReportContentGenerationJob_status, _ReportContentGenerationJob_attemptCount, _ReportContentGenerationJob_failureReason, _ReportContentGenerationJob_createdAt, _ReportContentGenerationJob_updatedAt, _ReportContentGenerationJob_startedAt, _ReportContentGenerationJob_completedAt;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportContentGenerationJob = void 0;
+const AggregateRoot_1 = require("../../../../shared/domain/entities/AggregateRoot");
+const ReportContentGenerationStatus_1 = require("../enums/ReportContentGenerationStatus");
+const ReportContentGenerationJobInvalidStatusTransitionError_1 = require("../exceptions/ReportContentGenerationJobInvalidStatusTransitionError");
+const ReportContentGenerationJobAttemptCount_1 = require("../value-objects/ReportContentGenerationJobAttemptCount");
+const ReportContentGenerationJobCarbonClientId_1 = require("../value-objects/ReportContentGenerationJobCarbonClientId");
+const ReportContentGenerationJobCompletedAt_1 = require("../value-objects/ReportContentGenerationJobCompletedAt");
+const ReportContentGenerationJobCreatedAt_1 = require("../value-objects/ReportContentGenerationJobCreatedAt");
+const ReportContentGenerationJobFailureReason_1 = require("../value-objects/ReportContentGenerationJobFailureReason");
+const ReportContentGenerationJobId_1 = require("../value-objects/ReportContentGenerationJobId");
+const ReportContentGenerationJobReportInstanceId_1 = require("../value-objects/ReportContentGenerationJobReportInstanceId");
+const ReportContentGenerationJobRequestedByStakeholderId_1 = require("../value-objects/ReportContentGenerationJobRequestedByStakeholderId");
+const ReportContentGenerationJobStartedAt_1 = require("../value-objects/ReportContentGenerationJobStartedAt");
+const ReportContentGenerationJobStatus_1 = require("../value-objects/ReportContentGenerationJobStatus");
+const ReportContentGenerationJobUpdatedAt_1 = require("../value-objects/ReportContentGenerationJobUpdatedAt");
+/**
+ * Asynchronous report content generation job (DT-83).
+ *
+ * One job per generation request of a `ReportInstance`. The API enqueues it (QUEUED), the
+ * worker Lambda drives it (PROCESSING → COMPLETED | FAILED) and the web polls it. The
+ * `ReportInstance` keeps its own lifecycle (GENERATING → PENDING_INTERNAL, or back to DRAFT
+ * when the job fails); the job only records the attempt, its outcome and who asked for it.
+ */
+class ReportContentGenerationJob extends AggregateRoot_1.AggregateRoot {
+    constructor(props, skipDomainValidation) {
+        const id = skipDomainValidation
+            ? ReportContentGenerationJobId_1.ReportContentGenerationJobId.fromPrimitives(props.id).toPrimitives()
+            : ReportContentGenerationJobId_1.ReportContentGenerationJobId.create(props.id).toPrimitives();
+        super({ id }, skipDomainValidation);
+        _ReportContentGenerationJob_reportInstanceId.set(this, void 0);
+        _ReportContentGenerationJob_carbonClientId.set(this, void 0);
+        _ReportContentGenerationJob_requestedByStakeholderId.set(this, void 0);
+        _ReportContentGenerationJob_status.set(this, void 0);
+        _ReportContentGenerationJob_attemptCount.set(this, void 0);
+        _ReportContentGenerationJob_failureReason.set(this, void 0);
+        _ReportContentGenerationJob_createdAt.set(this, void 0);
+        _ReportContentGenerationJob_updatedAt.set(this, void 0);
+        _ReportContentGenerationJob_startedAt.set(this, void 0);
+        _ReportContentGenerationJob_completedAt.set(this, void 0);
+        if (skipDomainValidation === false) {
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_reportInstanceId, ReportContentGenerationJobReportInstanceId_1.ReportContentGenerationJobReportInstanceId.create(props.reportInstanceId), "f");
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_carbonClientId, ReportContentGenerationJobCarbonClientId_1.ReportContentGenerationJobCarbonClientId.create(props.carbonClientId), "f");
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_requestedByStakeholderId, ReportContentGenerationJobRequestedByStakeholderId_1.ReportContentGenerationJobRequestedByStakeholderId.create(props.requestedByStakeholderId), "f");
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_status, ReportContentGenerationJobStatus_1.ReportContentGenerationJobStatus.create(props.status), "f");
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_attemptCount, ReportContentGenerationJobAttemptCount_1.ReportContentGenerationJobAttemptCount.create(props.attemptCount), "f");
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_failureReason, ReportContentGenerationJobFailureReason_1.ReportContentGenerationJobFailureReason.create(props.failureReason), "f");
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_createdAt, ReportContentGenerationJobCreatedAt_1.ReportContentGenerationJobCreatedAt.create(props.createdAt), "f");
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_updatedAt, ReportContentGenerationJobUpdatedAt_1.ReportContentGenerationJobUpdatedAt.create(props.updatedAt), "f");
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_startedAt, ReportContentGenerationJobStartedAt_1.ReportContentGenerationJobStartedAt.create(props.startedAt), "f");
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_completedAt, ReportContentGenerationJobCompletedAt_1.ReportContentGenerationJobCompletedAt.create(props.completedAt), "f");
+        }
+        else {
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_reportInstanceId, ReportContentGenerationJobReportInstanceId_1.ReportContentGenerationJobReportInstanceId.fromPrimitives(props.reportInstanceId), "f");
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_carbonClientId, ReportContentGenerationJobCarbonClientId_1.ReportContentGenerationJobCarbonClientId.fromPrimitives(props.carbonClientId), "f");
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_requestedByStakeholderId, ReportContentGenerationJobRequestedByStakeholderId_1.ReportContentGenerationJobRequestedByStakeholderId.fromPrimitives(props.requestedByStakeholderId), "f");
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_status, ReportContentGenerationJobStatus_1.ReportContentGenerationJobStatus.fromPrimitives(props.status), "f");
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_attemptCount, ReportContentGenerationJobAttemptCount_1.ReportContentGenerationJobAttemptCount.fromPrimitives(props.attemptCount), "f");
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_failureReason, ReportContentGenerationJobFailureReason_1.ReportContentGenerationJobFailureReason.fromPrimitives(props.failureReason), "f");
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_createdAt, ReportContentGenerationJobCreatedAt_1.ReportContentGenerationJobCreatedAt.fromPrimitives(props.createdAt), "f");
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_updatedAt, ReportContentGenerationJobUpdatedAt_1.ReportContentGenerationJobUpdatedAt.fromPrimitives(props.updatedAt), "f");
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_startedAt, ReportContentGenerationJobStartedAt_1.ReportContentGenerationJobStartedAt.fromPrimitives(props.startedAt), "f");
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_completedAt, ReportContentGenerationJobCompletedAt_1.ReportContentGenerationJobCompletedAt.fromPrimitives(props.completedAt), "f");
+        }
+    }
+    static create(props) {
+        return new ReportContentGenerationJob(props, false);
+    }
+    static fromPrimitives(primitives) {
+        return new ReportContentGenerationJob(primitives, true);
+    }
+    /**
+     * Transitions the job to PROCESSING and counts the attempt. Allowed from QUEUED (first
+     * delivery) and from PROCESSING (redelivery after a crash or timeout of the worker), so
+     * the worker can decide from `attemptCount` whether to resume or give up. Records
+     * `startedAt` on the first attempt only. Invalid from COMPLETED/FAILED.
+     */
+    markProcessing(nowDateTime) {
+        if (!__classPrivateFieldGet(this, _ReportContentGenerationJob_status, "f").canTransitionToProcessing()) {
+            throw ReportContentGenerationJobInvalidStatusTransitionError_1.ReportContentGenerationJobInvalidStatusTransitionError.create(this.id.toPrimitives(), __classPrivateFieldGet(this, _ReportContentGenerationJob_status, "f").toEnum(), ReportContentGenerationStatus_1.ReportContentGenerationStatus.PROCESSING);
+        }
+        __classPrivateFieldSet(this, _ReportContentGenerationJob_status, ReportContentGenerationJobStatus_1.ReportContentGenerationJobStatus.create(ReportContentGenerationStatus_1.ReportContentGenerationStatus.PROCESSING), "f");
+        __classPrivateFieldSet(this, _ReportContentGenerationJob_attemptCount, __classPrivateFieldGet(this, _ReportContentGenerationJob_attemptCount, "f").increment(), "f");
+        if (!__classPrivateFieldGet(this, _ReportContentGenerationJob_startedAt, "f").hasValue()) {
+            __classPrivateFieldSet(this, _ReportContentGenerationJob_startedAt, ReportContentGenerationJobStartedAt_1.ReportContentGenerationJobStartedAt.create(nowDateTime), "f");
+        }
+        __classPrivateFieldSet(this, _ReportContentGenerationJob_updatedAt, ReportContentGenerationJobUpdatedAt_1.ReportContentGenerationJobUpdatedAt.create(nowDateTime), "f");
+    }
+    /** Transitions the job to COMPLETED. Allowed only from PROCESSING. Sets `completedAt`. */
+    markCompleted(nowDateTime) {
+        if (!__classPrivateFieldGet(this, _ReportContentGenerationJob_status, "f").canTransitionToCompleted()) {
+            throw ReportContentGenerationJobInvalidStatusTransitionError_1.ReportContentGenerationJobInvalidStatusTransitionError.create(this.id.toPrimitives(), __classPrivateFieldGet(this, _ReportContentGenerationJob_status, "f").toEnum(), ReportContentGenerationStatus_1.ReportContentGenerationStatus.COMPLETED);
+        }
+        __classPrivateFieldSet(this, _ReportContentGenerationJob_status, ReportContentGenerationJobStatus_1.ReportContentGenerationJobStatus.create(ReportContentGenerationStatus_1.ReportContentGenerationStatus.COMPLETED), "f");
+        __classPrivateFieldSet(this, _ReportContentGenerationJob_failureReason, ReportContentGenerationJobFailureReason_1.ReportContentGenerationJobFailureReason.create(null), "f");
+        __classPrivateFieldSet(this, _ReportContentGenerationJob_updatedAt, ReportContentGenerationJobUpdatedAt_1.ReportContentGenerationJobUpdatedAt.create(nowDateTime), "f");
+        __classPrivateFieldSet(this, _ReportContentGenerationJob_completedAt, ReportContentGenerationJobCompletedAt_1.ReportContentGenerationJobCompletedAt.create(nowDateTime), "f");
+    }
+    /**
+     * Transitions the job to FAILED with the reason shown to the requester. Allowed from
+     * QUEUED (the queue rejected the message) or PROCESSING. Sets `completedAt`.
+     */
+    markFailed(failureReason, nowDateTime) {
+        if (!__classPrivateFieldGet(this, _ReportContentGenerationJob_status, "f").canTransitionToFailed()) {
+            throw ReportContentGenerationJobInvalidStatusTransitionError_1.ReportContentGenerationJobInvalidStatusTransitionError.create(this.id.toPrimitives(), __classPrivateFieldGet(this, _ReportContentGenerationJob_status, "f").toEnum(), ReportContentGenerationStatus_1.ReportContentGenerationStatus.FAILED);
+        }
+        __classPrivateFieldSet(this, _ReportContentGenerationJob_status, ReportContentGenerationJobStatus_1.ReportContentGenerationJobStatus.create(ReportContentGenerationStatus_1.ReportContentGenerationStatus.FAILED), "f");
+        __classPrivateFieldSet(this, _ReportContentGenerationJob_failureReason, ReportContentGenerationJobFailureReason_1.ReportContentGenerationJobFailureReason.create(failureReason), "f");
+        __classPrivateFieldSet(this, _ReportContentGenerationJob_updatedAt, ReportContentGenerationJobUpdatedAt_1.ReportContentGenerationJobUpdatedAt.create(nowDateTime), "f");
+        __classPrivateFieldSet(this, _ReportContentGenerationJob_completedAt, ReportContentGenerationJobCompletedAt_1.ReportContentGenerationJobCompletedAt.create(nowDateTime), "f");
+    }
+    isActive() {
+        return !__classPrivateFieldGet(this, _ReportContentGenerationJob_status, "f").isFinal();
+    }
+    hasReachedAttemptLimit(maxAttempts) {
+        return __classPrivateFieldGet(this, _ReportContentGenerationJob_attemptCount, "f").toPrimitives() >= maxAttempts;
+    }
+    get toPrimitives() {
+        return {
+            id: this.id.toPrimitives(),
+            reportInstanceId: __classPrivateFieldGet(this, _ReportContentGenerationJob_reportInstanceId, "f").toPrimitives(),
+            carbonClientId: __classPrivateFieldGet(this, _ReportContentGenerationJob_carbonClientId, "f").toPrimitives(),
+            requestedByStakeholderId: __classPrivateFieldGet(this, _ReportContentGenerationJob_requestedByStakeholderId, "f").toPrimitives(),
+            status: __classPrivateFieldGet(this, _ReportContentGenerationJob_status, "f").toEnum(),
+            attemptCount: __classPrivateFieldGet(this, _ReportContentGenerationJob_attemptCount, "f").toPrimitives(),
+            failureReason: __classPrivateFieldGet(this, _ReportContentGenerationJob_failureReason, "f").toPrimitives(),
+            createdAt: __classPrivateFieldGet(this, _ReportContentGenerationJob_createdAt, "f").toPrimitives(),
+            updatedAt: __classPrivateFieldGet(this, _ReportContentGenerationJob_updatedAt, "f").toPrimitives(),
+            startedAt: __classPrivateFieldGet(this, _ReportContentGenerationJob_startedAt, "f").toPrimitives(),
+            completedAt: __classPrivateFieldGet(this, _ReportContentGenerationJob_completedAt, "f").toPrimitives(),
+        };
+    }
+    get reportInstanceId() { return __classPrivateFieldGet(this, _ReportContentGenerationJob_reportInstanceId, "f"); }
+    get carbonClientId() { return __classPrivateFieldGet(this, _ReportContentGenerationJob_carbonClientId, "f"); }
+    get requestedByStakeholderId() { return __classPrivateFieldGet(this, _ReportContentGenerationJob_requestedByStakeholderId, "f"); }
+    get status() { return __classPrivateFieldGet(this, _ReportContentGenerationJob_status, "f"); }
+    get attemptCount() { return __classPrivateFieldGet(this, _ReportContentGenerationJob_attemptCount, "f"); }
+    get failureReason() { return __classPrivateFieldGet(this, _ReportContentGenerationJob_failureReason, "f"); }
+    get createdAt() { return __classPrivateFieldGet(this, _ReportContentGenerationJob_createdAt, "f"); }
+    get updatedAt() { return __classPrivateFieldGet(this, _ReportContentGenerationJob_updatedAt, "f"); }
+    get startedAt() { return __classPrivateFieldGet(this, _ReportContentGenerationJob_startedAt, "f"); }
+    get completedAt() { return __classPrivateFieldGet(this, _ReportContentGenerationJob_completedAt, "f"); }
+}
+exports.ReportContentGenerationJob = ReportContentGenerationJob;
+_ReportContentGenerationJob_reportInstanceId = new WeakMap(), _ReportContentGenerationJob_carbonClientId = new WeakMap(), _ReportContentGenerationJob_requestedByStakeholderId = new WeakMap(), _ReportContentGenerationJob_status = new WeakMap(), _ReportContentGenerationJob_attemptCount = new WeakMap(), _ReportContentGenerationJob_failureReason = new WeakMap(), _ReportContentGenerationJob_createdAt = new WeakMap(), _ReportContentGenerationJob_updatedAt = new WeakMap(), _ReportContentGenerationJob_startedAt = new WeakMap(), _ReportContentGenerationJob_completedAt = new WeakMap();

package/build/carbonbox/reporting/report-content-generation-jobs/domain/enums/ReportContentGenerationStatus.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportContentGenerationStatus = void 0;
+/**
+ * Lifecycle of an asynchronous report content generation job (DT-83).
+ * Mirrors `BulkImportStatus`: QUEUED → PROCESSING → COMPLETED | FAILED.
+ */
+var ReportContentGenerationStatus;
+(function (ReportContentGenerationStatus) {
+    ReportContentGenerationStatus["QUEUED"] = "QUEUED";
+    ReportContentGenerationStatus["PROCESSING"] = "PROCESSING";
+    ReportContentGenerationStatus["COMPLETED"] = "COMPLETED";
+    ReportContentGenerationStatus["FAILED"] = "FAILED";
+})(ReportContentGenerationStatus || (exports.ReportContentGenerationStatus = ReportContentGenerationStatus = {}));

package/build/carbonbox/reporting/report-content-generation-jobs/domain/exceptions/ReportContentGenerationJobInvalidStatusTransitionError.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportContentGenerationJobInvalidStatusTransitionError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+class ReportContentGenerationJobInvalidStatusTransitionError extends CodedRootError_1.CodedRootError {
+    constructor(jobId, currentStatus, targetStatus) {
+        const technicalMessage = `Invalid status transition for report content generation job '${jobId}'. Cannot transition from '${currentStatus}' to '${targetStatus}'.`;
+        const context = {
+            jobId,
+            currentStatus,
+            targetStatus,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'Follow the valid status flow: QUEUED → PROCESSING → COMPLETED | FAILED',
+            `Current status '${currentStatus}' does not allow transition to '${targetStatus}'`,
+            'A job in a final status (COMPLETED or FAILED) cannot be processed again; request a new generation instead',
+            `Verify the report content generation job '${jobId}' state before retrying`,
+        ];
+        super(ErrorCode_1.ErrorCode.REPORT_CONTENT_GENERATION_JOB_INVALID_STATUS_TRANSITION, technicalMessage, context, suggestions);
+        this.name = 'ReportContentGenerationJobInvalidStatusTransitionError';
+    }
+    static create(jobId, currentStatus, targetStatus) {
+        return new ReportContentGenerationJobInvalidStatusTransitionError(jobId, currentStatus, targetStatus);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.ReportContentGenerationJobInvalidStatusTransitionError = ReportContentGenerationJobInvalidStatusTransitionError;

package/build/carbonbox/reporting/report-content-generation-jobs/domain/repository/IReportContentGenerationJobRepository.js

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

package/build/carbonbox/reporting/report-content-generation-jobs/domain/types/ReportContentGenerationJobPrimitives.js

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

package/build/carbonbox/reporting/report-content-generation-jobs/domain/types/ReportContentGenerationJobProps.js

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

package/build/carbonbox/reporting/report-content-generation-jobs/domain/value-objects/ReportContentGenerationJobAttemptCount.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportContentGenerationJobAttemptCount = void 0;
+const Numeric_1 = require("../../../../shared/domain/value-objects/Numeric");
+class ReportContentGenerationJobAttemptCount extends Numeric_1.Numeric {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, ReportContentGenerationJobAttemptCount.PROPERTY_NAME, {
+            allowDecimals: false,
+            allowNegative: false,
+            minValue: 0,
+            maxValue: Number.MAX_SAFE_INTEGER,
+            allowZero: true,
+            maxDecimalPlaces: 0,
+        });
+    }
+    static create(value) {
+        return new ReportContentGenerationJobAttemptCount(value, false);
+    }
+    static fromPrimitives(primitive) {
+        return new ReportContentGenerationJobAttemptCount(primitive, true);
+    }
+    increment() {
+        return ReportContentGenerationJobAttemptCount.create(this.value + 1);
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.ReportContentGenerationJobAttemptCount = ReportContentGenerationJobAttemptCount;
+ReportContentGenerationJobAttemptCount.PROPERTY_NAME = 'attemptCount';

package/build/carbonbox/reporting/report-content-generation-jobs/domain/value-objects/ReportContentGenerationJobCarbonClientId.js

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

package/build/carbonbox/reporting/report-content-generation-jobs/domain/value-objects/ReportContentGenerationJobCompletedAt.js

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

package/build/carbonbox/reporting/report-content-generation-jobs/domain/value-objects/ReportContentGenerationJobCreatedAt.js

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

package/build/carbonbox/reporting/report-content-generation-jobs/domain/value-objects/ReportContentGenerationJobFailureReason.js

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

package/build/carbonbox/reporting/report-content-generation-jobs/domain/value-objects/ReportContentGenerationJobId.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportContentGenerationJobId = 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");
+class ReportContentGenerationJobId extends AggregateId_1.AggregateId {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, ReportContentGenerationJobId.PROPERTY_NAME);
+    }
+    static create(value) {
+        AggregateId_1.AggregateId.guardAgainstEmptyValue(value, ReportContentGenerationJobId.PROPERTY_NAME);
+        AggregateId_1.AggregateId.guardAgainstInvalidType(value, ReportContentGenerationJobId.PROPERTY_NAME);
+        AggregateId_1.AggregateId.guardAgainstInvalidId(value, ReportContentGenerationJobId.PROPERTY_NAME);
+        ReportContentGenerationJobId.guardAgainstInvalidPrefix(value);
+        return new ReportContentGenerationJobId(value, false);
+    }
+    static guardAgainstInvalidPrefix(value) {
+        try {
+            const tempInstance = new ReportContentGenerationJobId(value, true);
+            const prefix = tempInstance.extractPrefix();
+            if (ReportContentGenerationJobId.VALID_PREFIXES.includes(prefix) === false) {
+                throw InvalidAggregatePrefixError_1.InvalidAggregatePrefixError.create(value, 'ReportContentGenerationJob', prefix, ReportContentGenerationJobId.VALID_PREFIXES, ReportContentGenerationJobId.PROPERTY_NAME);
+            }
+        }
+        catch (error) {
+            if (error instanceof InvalidAggregatePrefixError_1.InvalidAggregatePrefixError) {
+                throw error;
+            }
+            throw InvalidAggregatePrefixError_1.InvalidAggregatePrefixError.create(value, 'ReportContentGenerationJob', 'UNKNOWN', ReportContentGenerationJobId.VALID_PREFIXES, ReportContentGenerationJobId.PROPERTY_NAME);
+        }
+    }
+    static fromPrimitives(primitive) {
+        return new ReportContentGenerationJobId(primitive, true);
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.ReportContentGenerationJobId = ReportContentGenerationJobId;
+ReportContentGenerationJobId.PROPERTY_NAME = 'id';
+ReportContentGenerationJobId.VALID_PREFIXES = [
+    SemanticUuidPrefix_1.SemanticUuidPrefix.RPT_CONTENT_GENERATION_JOB,
+];

package/build/carbonbox/reporting/report-content-generation-jobs/domain/value-objects/ReportContentGenerationJobReportInstanceId.js

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

package/build/carbonbox/reporting/report-content-generation-jobs/domain/value-objects/ReportContentGenerationJobRequestedByStakeholderId.js

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

package/build/carbonbox/reporting/report-content-generation-jobs/domain/value-objects/ReportContentGenerationJobStartedAt.js

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

package/build/carbonbox/reporting/report-content-generation-jobs/domain/value-objects/ReportContentGenerationJobStatus.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportContentGenerationJobStatus = void 0;
+const InvalidPropertyValueError_1 = require("../../../../shared/domain/exceptions/InvalidPropertyValueError");
+const String_1 = require("../../../../shared/domain/value-objects/String");
+const ReportContentGenerationStatus_1 = require("../enums/ReportContentGenerationStatus");
+class ReportContentGenerationJobStatus extends String_1.String {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, ReportContentGenerationJobStatus.PROPERTY_NAME);
+        if (skipDomainValidation === false) {
+            ReportContentGenerationJobStatus.validateStatus(value);
+        }
+    }
+    static create(value) {
+        String_1.String.guardAgainstEmptyValue(value, ReportContentGenerationJobStatus.PROPERTY_NAME);
+        String_1.String.guardAgainstInvalidType(value, ReportContentGenerationJobStatus.PROPERTY_NAME);
+        return new ReportContentGenerationJobStatus(value, false);
+    }
+    static fromPrimitives(primitive) {
+        return new ReportContentGenerationJobStatus(primitive, true);
+    }
+    static validateStatus(value) {
+        if (!ReportContentGenerationJobStatus.VALID_STATUSES.includes(value)) {
+            throw InvalidPropertyValueError_1.InvalidPropertyValueError.create(ReportContentGenerationJobStatus.PROPERTY_NAME, `one of ${ReportContentGenerationJobStatus.VALID_STATUSES.join(', ')}`, value);
+        }
+    }
+    isQueued() {
+        return this.value === ReportContentGenerationStatus_1.ReportContentGenerationStatus.QUEUED;
+    }
+    isProcessing() {
+        return this.value === ReportContentGenerationStatus_1.ReportContentGenerationStatus.PROCESSING;
+    }
+    isCompleted() {
+        return this.value === ReportContentGenerationStatus_1.ReportContentGenerationStatus.COMPLETED;
+    }
+    isFailed() {
+        return this.value === ReportContentGenerationStatus_1.ReportContentGenerationStatus.FAILED;
+    }
+    isFinal() {
+        return this.isCompleted() || this.isFailed();
+    }
+    canTransitionToProcessing() {
+        return this.isQueued() || this.isProcessing();
+    }
+    canTransitionToCompleted() {
+        return this.isProcessing();
+    }
+    canTransitionToFailed() {
+        return this.isQueued() || this.isProcessing();
+    }
+    toEnum() {
+        return this.value;
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.ReportContentGenerationJobStatus = ReportContentGenerationJobStatus;
+ReportContentGenerationJobStatus.PROPERTY_NAME = 'status';
+ReportContentGenerationJobStatus.VALID_STATUSES = Object.values(ReportContentGenerationStatus_1.ReportContentGenerationStatus);

package/build/carbonbox/reporting/report-content-generation-jobs/domain/value-objects/ReportContentGenerationJobUpdatedAt.js

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

package/build/carbonbox/reporting/shared/domain/enums/DataBindingSource.js

@@ -43,9 +43,10 @@ var DataBindingSource;
     DataBindingSource["AGGREGATION_GAS_N2O"] = "aggregation.gas.n2o";
     // Aggregations - By Segment
     DataBindingSource["AGGREGATION_BY_SEGMENT"] = "aggregation.bySegment";
-    // Aggregations - Biogenic
-    DataBindingSource["AGGREGATION_BIOGENIC"] = "aggregation.biogenic";
+    // Aggregations - Biogenic CO₂ (informational item OUTSIDE the inventory total and the scopes,
+    // GHG Protocol cap. 9 / ISO 14064-1 §9.3.1): the `CO2-BIOGENIC` species, total and per source.
     DataBindingSource["AGGREGATION_BIOGENIC_CO2"] = "aggregation.biogenicCO2";
+    DataBindingSource["AGGREGATION_BIOGENIC_CO2_BY_SOURCE"] = "aggregation.biogenicCO2.bySource";
     // Aggregations - Uncertainty (GAP 4): inventory-level propagated uncertainty
     DataBindingSource["AGGREGATION_UNCERTAINTY_PERCENTAGE"] = "aggregation.uncertainty.percentage";
     DataBindingSource["AGGREGATION_UNCERTAINTY_LEVEL"] = "aggregation.uncertainty.level";

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

@@ -164,6 +164,7 @@ var ErrorCode;
     ErrorCode["INVALID_PREPARATION_QUESTION"] = "CBX-RPT-026";
     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";
     // Shared/Common Errors (CBX-SHR-XXX)
     ErrorCode["INVALID_EMAIL"] = "CBX-SHR-001";
     ErrorCode["INVALID_DATE_FORMAT"] = "CBX-SHR-002";

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

@@ -85,6 +85,7 @@ var SemanticUuidPrefix;
     SemanticUuidPrefix["RPT_BLOCK"] = "RPT-BLK";
     SemanticUuidPrefix["RPT_PREPARATION_QUESTIONNAIRE"] = "RPT-PRE";
     SemanticUuidPrefix["RPT_PREPARATION_QUESTION"] = "RPT-PRE-QST";
+    SemanticUuidPrefix["RPT_CONTENT_GENERATION_JOB"] = "RPT-CGJ";
     // 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