@carbonbox/domain 0.4.13 → 0.4.14

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

@@ -0,0 +1,290 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AggregateIdDomainService = void 0;
+const either_1 = require("../../../either");
+const SemanticUuidPrefix_1 = require("../../enums/SemanticUuidPrefix");
+const InvalidAggregateIdFormatError_1 = require("../../exceptions/InvalidAggregateIdFormatError");
+const UnknownBoundedContextCodeError_1 = require("../../exceptions/UnknownBoundedContextCodeError");
+const InvalidSemanticUuidFormatError_1 = require("../../exceptions/InvalidSemanticUuidFormatError");
+const InvalidUuidFormatError_1 = require("../../exceptions/InvalidUuidFormatError");
+/**
+ * Domain Service for aggregate ID parsing, validation and business logic operations.
+ * Provides centralized business logic for aggregate ID handling across the domain.
+ * Refactored to support dependency injection and Either pattern for error handling.
+ *
+ * This service maintains Value Object purity by being used in factories,
+ * application services, and other appropriate contexts.
+ */
+class AggregateIdDomainService {
+    constructor() {
+        // Aggregate ID format: BC_ID or BC-SUB1-SUB2-...SUBn_ID
+        this.AGGREGATE_ID_REGEX = /^[A-Z]{3}(-[A-Z]{3})*_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+        // Standard ID regex (UUID v4 format)
+        this.ID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+        // Private constructor to enforce factory pattern
+    }
+    static create() {
+        return new AggregateIdDomainService();
+    }
+    /**
+     * Validates if a string is a valid aggregate ID prefix
+     */
+    isValidPrefix(prefix) {
+        return either_1.EitherFactory.fromTryCatch(() => {
+            if (typeof prefix !== 'string') {
+                return false;
+            }
+            return Object.values(SemanticUuidPrefix_1.SemanticUuidPrefix).includes(prefix);
+        }, (error) => {
+            if (error instanceof InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError) {
+                return error;
+            }
+            return InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError.create(prefix, 'Failed to validate prefix');
+        });
+    }
+    /**
+     * Gets the bounded context name from an aggregate ID prefix
+     */
+    getBoundedContext(prefix) {
+        return either_1.EitherFactory.fromTryCatch(() => {
+            const boundedContextMap = {
+                // BC-Level entities
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.STC]: 'System Technical Configuration',
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.USR]: 'Users',
+                // Activity Data Collection bounded context
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.ADC_SUBMISSIONS]: 'Activity Data Collection Submissions',
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.ADC_FIELDS]: 'Activity Data Collection Fields',
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.ADC_LOGIC]: 'Activity Data Collection Logic',
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.ADC_LABELS]: 'Activity Data Collection Labels',
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.ADC_FORMS]: 'Activity Data Collection Forms',
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.ADC_ADAPTATIONS]: 'Activity Data Collection Adaptations',
+                // Carbon Footprint Configurations bounded context
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.CFC_CORPORATE]: 'Carbon Footprint Corporate Configuration',
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.CFC_EVENT]: 'Carbon Footprint Event Configuration',
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.CFC_PRODUCT]: 'Carbon Footprint Product Configuration',
+                // Company Resources bounded context
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.CPR_EVENTS]: 'Company Resources Events',
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.CPR_FACILITIES]: 'Company Resources Facilities',
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.CPR_PRODUCTS]: 'Company Resources Products',
+                // Emission Calculation Formulas bounded context
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.ECF_VARIABLES]: 'Emission Calculation Formula Variables',
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.ECF_FACTORS]: 'Emission Calculation Formula Factors',
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.ECF_GWP]: 'Emission Calculation Formula GWP',
+                // Emission Calculation Process bounded context
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.ECP_JOBS]: 'Emission Calculation Process Jobs',
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.ECP_PROCESSES]: 'Emission Calculation Process Processes',
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.ECP_WORKFLOWS]: 'Emission Calculation Process Workflows',
+                // Emission Calculation Results bounded context
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.ECR_AGGREGATIONS]: 'Emission Calculation Results Aggregations',
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.ECR_CALCULATIONS]: 'Emission Calculation Results Calculations',
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.ECR_GHG_RESULTS]: 'Emission Calculation Results GHG',
+                // Users - Stakeholders
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_CLIENT]: 'User Stakeholder Client',
+                [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',
+                // Shared Domain
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.SHR_DOMAIN]: 'Shared Domain',
+                [SemanticUuidPrefix_1.SemanticUuidPrefix.SHR_EITHER]: 'Shared Either',
+            };
+            const boundedContext = boundedContextMap[prefix];
+            if (!boundedContext) {
+                throw UnknownBoundedContextCodeError_1.UnknownBoundedContextCodeError.create(prefix, 'Unknown bounded context for prefix');
+            }
+            return boundedContext;
+        }, (error) => {
+            if (error instanceof InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError || error instanceof UnknownBoundedContextCodeError_1.UnknownBoundedContextCodeError) {
+                return InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError.create(prefix, error.message);
+            }
+            return InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError.create(prefix, 'Failed to get bounded context');
+        });
+    }
+    /**
+     * Gets the subdomain from an aggregate ID prefix
+     */
+    getSubdomain(prefix) {
+        return either_1.EitherFactory.fromTryCatch(() => {
+            // Extract subdomain from prefix (everything after the first hyphen)
+            if (!prefix.includes('-')) {
+                return ''; // No subdomain for BC-level prefixes
+            }
+            const parts = prefix.split('-');
+            return parts.slice(1).join('-'); // Return all subdomain parts joined
+        }, (error) => {
+            if (error instanceof InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError) {
+                return error;
+            }
+            return InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError.create(prefix, 'Failed to extract subdomain');
+        });
+    }
+    /**
+     * Gets all available prefixes as an array
+     */
+    getAllPrefixes() {
+        return either_1.EitherFactory.fromTryCatch(() => Object.values(SemanticUuidPrefix_1.SemanticUuidPrefix), (error) => {
+            if (error instanceof InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError) {
+                return error;
+            }
+            return InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError.create('', 'Failed to get all prefixes');
+        });
+    }
+    /**
+     * Gets prefixes by bounded context
+     */
+    getPrefixesByBoundedContext(boundedContext) {
+        return either_1.EitherFactory.fromTryCatch(() => {
+            const prefixesByContext = {
+                'Activity Data Collection Submissions': [SemanticUuidPrefix_1.SemanticUuidPrefix.ADC_SUBMISSIONS],
+                'Activity Data Collection Fields': [SemanticUuidPrefix_1.SemanticUuidPrefix.ADC_FIELDS],
+                'Activity Data Collection Logic': [SemanticUuidPrefix_1.SemanticUuidPrefix.ADC_LOGIC],
+                'Activity Data Collection Labels': [SemanticUuidPrefix_1.SemanticUuidPrefix.ADC_LABELS],
+                'Activity Data Collection Forms': [SemanticUuidPrefix_1.SemanticUuidPrefix.ADC_FORMS],
+                'Activity Data Collection Adaptations': [SemanticUuidPrefix_1.SemanticUuidPrefix.ADC_ADAPTATIONS],
+                'Carbon Footprint Corporate Configuration': [SemanticUuidPrefix_1.SemanticUuidPrefix.CFC_CORPORATE],
+                'Carbon Footprint Event Configuration': [SemanticUuidPrefix_1.SemanticUuidPrefix.CFC_EVENT],
+                'Carbon Footprint Product Configuration': [SemanticUuidPrefix_1.SemanticUuidPrefix.CFC_PRODUCT],
+                'Company Resources Events': [SemanticUuidPrefix_1.SemanticUuidPrefix.CPR_EVENTS],
+                'Company Resources Facilities': [SemanticUuidPrefix_1.SemanticUuidPrefix.CPR_FACILITIES],
+                'Company Resources Products': [SemanticUuidPrefix_1.SemanticUuidPrefix.CPR_PRODUCTS],
+                'Emission Calculation Formula Variables': [SemanticUuidPrefix_1.SemanticUuidPrefix.ECF_VARIABLES],
+                'Emission Calculation Formula Factors': [SemanticUuidPrefix_1.SemanticUuidPrefix.ECF_FACTORS],
+                'Emission Calculation Formula GWP': [SemanticUuidPrefix_1.SemanticUuidPrefix.ECF_GWP],
+                'Emission Calculation Process Jobs': [SemanticUuidPrefix_1.SemanticUuidPrefix.ECP_JOBS],
+                'Emission Calculation Process Processes': [SemanticUuidPrefix_1.SemanticUuidPrefix.ECP_PROCESSES],
+                'Emission Calculation Process Workflows': [SemanticUuidPrefix_1.SemanticUuidPrefix.ECP_WORKFLOWS],
+                'Emission Calculation Results Aggregations': [SemanticUuidPrefix_1.SemanticUuidPrefix.ECR_AGGREGATIONS],
+                'Emission Calculation Results Calculations': [SemanticUuidPrefix_1.SemanticUuidPrefix.ECR_CALCULATIONS],
+                'Emission Calculation Results GHG': [SemanticUuidPrefix_1.SemanticUuidPrefix.ECR_GHG_RESULTS],
+                'System Technical Configuration': [SemanticUuidPrefix_1.SemanticUuidPrefix.STC],
+                Users: [SemanticUuidPrefix_1.SemanticUuidPrefix.USR],
+                'User Stakeholder Client': [SemanticUuidPrefix_1.SemanticUuidPrefix.USR_STH_CLIENT],
+                '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],
+                'Shared Domain': [SemanticUuidPrefix_1.SemanticUuidPrefix.SHR_DOMAIN],
+                'Shared Either': [SemanticUuidPrefix_1.SemanticUuidPrefix.SHR_EITHER],
+            };
+            const prefixes = prefixesByContext[boundedContext];
+            if (!prefixes) {
+                throw UnknownBoundedContextCodeError_1.UnknownBoundedContextCodeError.create(boundedContext, 'Unknown bounded context');
+            }
+            return prefixes;
+        }, (error) => {
+            if (error instanceof InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError || error instanceof UnknownBoundedContextCodeError_1.UnknownBoundedContextCodeError) {
+                return InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError.create(boundedContext, error.message);
+            }
+            return InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError.create(boundedContext, 'Failed to get prefixes by bounded context');
+        });
+    }
+    /**
+     * Validates a complete aggregate ID format
+     */
+    validateAggregateIdFormat(aggregateId) {
+        return either_1.EitherFactory.fromTryCatch(() => {
+            if (typeof aggregateId !== 'string') {
+                return false;
+            }
+            return this.AGGREGATE_ID_REGEX.test(aggregateId);
+        }, (error) => {
+            if (error instanceof InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError) {
+                return error;
+            }
+            return InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError.create(aggregateId, 'Failed to validate aggregate ID format');
+        });
+    }
+    /**
+     * Extracts and validates the prefix from an aggregate ID
+     */
+    extractPrefix(aggregateId) {
+        return either_1.EitherFactory.fromTryCatch(() => {
+            if (!this.AGGREGATE_ID_REGEX.test(aggregateId)) {
+                throw InvalidSemanticUuidFormatError_1.InvalidSemanticUuidFormatError.create(aggregateId, 'Invalid aggregate ID format');
+            }
+            const parts = aggregateId.split('_');
+            if (parts.length !== 2) {
+                throw InvalidSemanticUuidFormatError_1.InvalidSemanticUuidFormatError.create(aggregateId, 'Invalid aggregate ID structure');
+            }
+            return parts[0];
+        }, (error) => {
+            if (error instanceof InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError || error instanceof InvalidSemanticUuidFormatError_1.InvalidSemanticUuidFormatError) {
+                return InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError.create(aggregateId, error.message);
+            }
+            return InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError.create(aggregateId, 'Failed to extract prefix');
+        });
+    }
+    /**
+     * Extracts and validates the ID from an aggregate ID
+     */
+    extractId(aggregateId) {
+        return either_1.EitherFactory.fromTryCatch(() => {
+            if (!this.AGGREGATE_ID_REGEX.test(aggregateId)) {
+                throw InvalidSemanticUuidFormatError_1.InvalidSemanticUuidFormatError.create(aggregateId, 'Invalid aggregate ID format');
+            }
+            const parts = aggregateId.split('_');
+            if (parts.length !== 2) {
+                throw InvalidSemanticUuidFormatError_1.InvalidSemanticUuidFormatError.create(aggregateId, 'Invalid aggregate ID structure');
+            }
+            const rawId = parts[1];
+            if (!this.ID_REGEX.test(rawId)) {
+                throw InvalidUuidFormatError_1.InvalidUuidFormatError.create(rawId, 'Invalid ID format');
+            }
+            return rawId;
+        }, (error) => {
+            if (error instanceof InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError
+                || error instanceof InvalidSemanticUuidFormatError_1.InvalidSemanticUuidFormatError
+                || error instanceof InvalidUuidFormatError_1.InvalidUuidFormatError) {
+                return InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError.create(aggregateId, error.message);
+            }
+            return InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError.create(aggregateId, 'Failed to extract ID');
+        });
+    }
+    /**
+     * Extracts the bounded context code (first 3 letters) from an aggregate ID
+     */
+    extractBoundedContextCode(aggregateId) {
+        return this.extractPrefix(aggregateId).flatMap((prefix) => either_1.EitherFactory.fromTryCatch(() => prefix.substring(0, 3), (error) => {
+            if (error instanceof InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError) {
+                return error;
+            }
+            return InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError.create(aggregateId, 'Failed to extract bounded context code');
+        }));
+    }
+    /**
+     * Extracts all subdomain parts from an aggregate ID
+     */
+    extractSubdomains(aggregateId) {
+        return this.extractPrefix(aggregateId).flatMap((prefix) => either_1.EitherFactory.fromTryCatch(() => {
+            const parts = prefix.split('-');
+            // Remove the first part (BC) and return the rest (SUB1, SUB2, ...)
+            return parts.slice(1);
+        }, (error) => {
+            if (error instanceof InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError) {
+                return error;
+            }
+            return InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError.create(aggregateId, 'Failed to extract subdomains');
+        }));
+    }
+    /**
+     * Checks if an aggregate ID has subdomains or is BC-level only
+     */
+    hasSubdomains(aggregateId) {
+        return this.extractSubdomains(aggregateId).map((subdomains) => subdomains.length > 0);
+    }
+    /**
+     * Creates a human-readable log representation of an aggregate ID
+     */
+    toLogString(aggregateId) {
+        return this.extractPrefix(aggregateId)
+            .flatMap((prefix) => this.extractId(aggregateId).map((id) => ({ prefix, id })))
+            .flatMap(({ prefix, id }) => this.getBoundedContext(prefix).map((boundedContext) => ({
+            prefix,
+            id,
+            boundedContext,
+        })))
+            .map(({ prefix, id, boundedContext }) => {
+            const shortId = id.substring(0, 8);
+            return `[${boundedContext}] ${prefix}_${shortId}...`;
+        });
+    }
+}
+exports.AggregateIdDomainService = AggregateIdDomainService;

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

@@ -88,7 +88,7 @@ class ActivityDataSubmissionReference extends ObjectValueObject_1.ObjectValueObj
      */
     static guardAgainstInvalidId(id) {
         String_1.String.guardAgainstEmptyValue(id, 'id');
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(id, 'id');
+        AggregateId_1.AggregateId.guardAgainstInvalidId(id, 'id');
     }
     /**
      * Valida el código del formulario dinámico.

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

@@ -3,18 +3,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AggregateId = void 0;
 const String_1 = require("./String");
 const InvalidAggregateIdError_1 = require("../exceptions/InvalidAggregateIdError");
-const InvalidSemanticUuidError_1 = require("../exceptions/InvalidSemanticUuidError");
+const InvalidAggregateIdFormatError_1 = require("../exceptions/InvalidAggregateIdFormatError");
 /**
- * Pure AggregateId Value Object with semantic UUID format
+ * Pure AggregateId Value Object with structured ID format
  *
- * Format: {BC}_{UUID} or {BC}-{SUB1}-{SUB2}-...{SUBn}_{UUID}
+ * Format: {BC}_{ID} or {BC}-{SUB1}-{SUB2}-...{SUBn}_{ID}
  * Examples:
  * - STC_550e8400-e29b-41d4-a716-446655440000 (BC-level entity)
  * - USR-STH-CHO_550e8400-e29b-41d4-a716-446655440000 (subdomain entity)
  * - ADC-SUB-FLD_123e4567-e89b-12d3-a456-426614174000 (future N-level expansion)
  *
  * This is a PURE Value Object - no external dependencies or business logic.
- * For semantic parsing and business logic, use SemanticUuidDomainService.
  *
  * Benefits:
  * - Immutable and pure value object design
@@ -26,7 +25,7 @@ class AggregateId extends String_1.String {
     constructor(value, skipDomainValidation, propertyName = AggregateId.DEFAULT_PROPERTY_NAME) {
         super(value, skipDomainValidation, propertyName);
         if (skipDomainValidation === false) {
-            AggregateId.guardAgainstInvalidSemanticId(value, propertyName);
+            AggregateId.guardAgainstInvalidId(value, propertyName);
         }
     }
     static create(id) {
@@ -36,22 +35,22 @@ class AggregateId extends String_1.String {
         return new AggregateId(id, true);
     }
     /**
-     * Extracts the raw UUID from the semantic UUID
+     * Extracts the raw ID from the aggregate ID
      */
-    extractUuid() {
+    extractId() {
         const parts = this.value.split('_');
         if (parts.length !== 2) {
-            throw InvalidSemanticUuidError_1.InvalidSemanticUuidError.create(this.value, 'Invalid semantic UUID format');
+            throw InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError.create(this.value, 'Invalid aggregate ID format');
         }
         return parts[1];
     }
     /**
-     * Extracts the full prefix from the semantic UUID (BC-SUB1-SUB2-...SUBn)
+     * Extracts the full prefix from the aggregate ID (BC-SUB1-SUB2-...SUBn)
      */
     extractPrefix() {
         const parts = this.value.split('_');
         if (parts.length !== 2) {
-            throw InvalidSemanticUuidError_1.InvalidSemanticUuidError.create(this.value, 'Invalid semantic UUID format');
+            throw InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError.create(this.value, 'Invalid aggregate ID format');
         }
         return parts[0];
     }
@@ -64,7 +63,7 @@ class AggregateId extends String_1.String {
     }
     /**
      * Extracts all subdomain parts from the prefix
-     * Returns empty array if BC has no subdomains (e.g., STC_uuid)
+     * Returns empty array if BC has no subdomains (e.g., STC_id)
      */
     extractSubdomains() {
         const prefix = this.extractPrefix();
@@ -82,7 +81,7 @@ class AggregateId extends String_1.String {
         return subdomains.length > 0 ? subdomains[0] : '';
     }
     /**
-     * Checks if this UUID has subdomains or is BC-level only
+     * Checks if this ID has subdomains or is BC-level only
      */
     hasSubdomains() {
         return this.extractSubdomains().length > 0;
@@ -90,36 +89,33 @@ class AggregateId extends String_1.String {
     /**
      * Validation methods
      */
-    static guardAgainstInvalidSemanticId(semanticId, propertyName = AggregateId.DEFAULT_PROPERTY_NAME) {
-        if (this.isInvalidSemanticId(semanticId)) {
-            throw InvalidSemanticUuidError_1.InvalidSemanticUuidError.create(semanticId, propertyName);
+    static guardAgainstInvalidId(id, propertyName = AggregateId.DEFAULT_PROPERTY_NAME) {
+        if (this.isInvalidId(id)) {
+            throw InvalidAggregateIdFormatError_1.InvalidAggregateIdFormatError.create(id, propertyName);
         }
     }
-    static guardAgainstInvalidUuid(uuid, propertyName = 'uuid') {
-        if (this.isInvalidUuid(uuid)) {
-            throw InvalidAggregateIdError_1.InvalidAggregateIdError.create(uuid, `Invalid UUID format for ${propertyName}`);
+    static guardAgainstInvalidRawId(rawId, propertyName = 'id') {
+        if (this.isInvalidRawId(rawId)) {
+            throw InvalidAggregateIdError_1.InvalidAggregateIdError.create(rawId, `Invalid ID format for ${propertyName}`);
         }
     }
-    static isInvalidSemanticId(semanticId) {
-        return this.isValidSemanticId(semanticId) === false;
+    static isInvalidId(id) {
+        return this.isValidId(id) === false;
     }
-    static isInvalidUuid(uuid) {
-        return this.isValidUuid(uuid) === false;
-    }
-    static isValidSemanticId(semanticId) {
-        return AggregateId.SEMANTIC_UUID_REGEX.test(semanticId);
-    }
-    static isValidUuid(uuid) {
-        return AggregateId.UUID_REGEX.test(uuid);
+    static isInvalidRawId(rawId) {
+        return this.isValidRawId(rawId) === false;
     }
     static isValidId(id) {
-        return this.isValidSemanticId(id);
+        return AggregateId.AGGREGATE_ID_REGEX.test(id);
+    }
+    static isValidRawId(rawId) {
+        return AggregateId.ID_REGEX.test(rawId);
     }
-    static isValidSemanticIdValue(semanticId) {
-        return this.isValidSemanticId(semanticId);
+    static isValidIdValue(id) {
+        return this.isValidId(id);
     }
-    static isValidUuidValue(uuid) {
-        return this.isValidUuid(uuid);
+    static isValidRawIdValue(rawId) {
+        return this.isValidRawId(rawId);
     }
     toPrimitives() {
         return this.value;
@@ -127,8 +123,8 @@ class AggregateId extends String_1.String {
 }
 exports.AggregateId = AggregateId;
 AggregateId.DEFAULT_PROPERTY_NAME = 'id';
-// Standard UUID v4 regex
-AggregateId.UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-// Semantic UUID format: BC_UUID or BC-SUB1-SUB2-...SUBn_UUID (flexible N-level subdomain support)
-// Pattern: [A-Z]{3}(-[A-Z]{3})*_[UUID] - BC alone OR BC with unlimited SUBn levels
-AggregateId.SEMANTIC_UUID_REGEX = /^[A-Z]{3}(-[A-Z]{3})*_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+// Standard ID regex (UUID v4 format)
+AggregateId.ID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+// Aggregate ID format: BC_ID or BC-SUB1-SUB2-...SUBn_ID (flexible N-level subdomain support)
+// Pattern: [A-Z]{3}(-[A-Z]{3})*_[ID] - BC alone OR BC with unlimited SUBn levels
+AggregateId.AGGREGATE_ID_REGEX = /^[A-Z]{3}(-[A-Z]{3})*_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;

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

@@ -17,7 +17,7 @@ class AggregateIdList extends StringList_1.StringList {
     }
     static guardAgainstInvalidIds(ids, propertyName = AggregateIdList.DEFAULT_PROPERTY_NAME) {
         ids.forEach((id, index) => {
-            if (!AggregateId_1.AggregateId.isValidId(id)) {
+            if (!AggregateId_1.AggregateId.isValidIdValue(id)) {
                 throw InvalidAggregateIdError_1.InvalidAggregateIdError.create(id, `${propertyName}[${index}]`);
             }
         });
@@ -31,7 +31,7 @@ class AggregateIdList extends StringList_1.StringList {
         return this.value.includes(id);
     }
     addId(id) {
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(id);
+        AggregateId_1.AggregateId.guardAgainstInvalidId(id);
         if (this.hasId(id)) {
             return this.value;
         }
@@ -47,7 +47,7 @@ class AggregateIdList extends StringList_1.StringList {
         return this.value.length;
     }
     static isValidIdList(ids) {
-        return ids.every((id) => AggregateId_1.AggregateId.isValidId(id));
+        return ids.every((id) => AggregateId_1.AggregateId.isValidIdValue(id));
     }
     toPrimitives() {
         return this.value;

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

@@ -59,15 +59,15 @@ class CalculationProcessReference extends ObjectValueObject_1.ObjectValueObject
     }
     static guardAgainstInvalidId(id) {
         String_1.String.guardAgainstEmptyValue(id, 'id');
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(id, 'id');
+        AggregateId_1.AggregateId.guardAgainstInvalidId(id, 'id');
     }
     static guardAgainstInvalidCarbonClient(carbonClient) {
         String_1.String.guardAgainstEmptyValue(carbonClient, 'carbonClient');
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(carbonClient, 'carbonClient');
+        AggregateId_1.AggregateId.guardAgainstInvalidId(carbonClient, 'carbonClient');
     }
     static guardAgainstInvalidFootprintConfiguration(footprintConfiguration) {
         String_1.String.guardAgainstEmptyValue(footprintConfiguration, 'footprintConfiguration');
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(footprintConfiguration, 'footprintConfiguration');
+        AggregateId_1.AggregateId.guardAgainstInvalidId(footprintConfiguration, 'footprintConfiguration');
     }
     get id() {
         return __classPrivateFieldGet(this, _CalculationProcessReference_id, "f");

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

@@ -108,7 +108,7 @@ class CalculationVariableReferences extends ValueObject_1.ValueObject {
         }
         // Validar usando las reglas de dominio
         String_1.String.guardAgainstEmptyValue(reference.id, `${propertyName}.id`);
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(reference.id, `${propertyName}.id`);
+        AggregateId_1.AggregateId.guardAgainstInvalidId(reference.id, `${propertyName}.id`);
         String_1.String.guardAgainstEmptyValue(reference.code, `${propertyName}.code`);
         Code_1.Code.guardAgainstInvalidCode(reference.code);
         String_1.String.guardAgainstEmptyValue(reference.symbol, `${propertyName}.symbol`);

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

@@ -94,7 +94,7 @@ class CarbonClientReference extends ObjectValueObject_1.ObjectValueObject {
      */
     static guardAgainstInvalidId(id) {
         String_1.String.guardAgainstEmptyValue(id, 'id');
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(id, 'id');
+        AggregateId_1.AggregateId.guardAgainstInvalidId(id, 'id');
     }
     /**
      * Valida el nombre para mostrar.

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

@@ -57,7 +57,7 @@ class CarbonFootprintConfigurationReference extends ObjectValueObject_1.ObjectVa
     }
     static guardAgainstInvalidId(id) {
         String_1.String.guardAgainstEmptyValue(id, 'id');
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(id, 'id');
+        AggregateId_1.AggregateId.guardAgainstInvalidId(id, 'id');
     }
     /**
      * Valida el tipo de huella de carbono.

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

@@ -83,7 +83,7 @@ class CarbonFootprintIntensityIndicatorReference extends ObjectValueObject_1.Obj
     }
     static guardAgainstInvalidId(id) {
         String_1.String.guardAgainstEmptyValue(id, 'id');
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(id, 'id');
+        AggregateId_1.AggregateId.guardAgainstInvalidId(id, 'id');
     }
     /**
      * Valida el código del indicador de intensidad usando las validaciones de DomainCode.

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

@@ -104,7 +104,7 @@ class CarbonFootprintSegmentReferences extends ValueObject_1.ValueObject {
      */
     static guardAgainstInvalidSegmentId(id, propertyName) {
         String_1.String.guardAgainstEmptyValue(id, propertyName);
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(id, propertyName);
+        AggregateId_1.AggregateId.guardAgainstInvalidId(id, propertyName);
     }
     /**
      * Valida el código de segmento usando las validaciones de Code.

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

@@ -77,7 +77,7 @@ class CollectionFieldReference extends ObjectValueObject_1.ObjectValueObject {
     }
     static guardAgainstInvalidId(id) {
         String_1.String.guardAgainstEmptyValue(id, 'id');
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(id, 'id');
+        AggregateId_1.AggregateId.guardAgainstInvalidId(id, 'id');
     }
     /**
      * Valida el código del campo de recolección usando las validaciones de Code.

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

@@ -109,7 +109,7 @@ class CorporateCarbonFootprintSegmentConfigurationReferences extends ValueObject
      */
     static guardAgainstInvalidConfigurationId(id, propertyName) {
         String_1.String.guardAgainstEmptyValue(id, propertyName);
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(id, propertyName);
+        AggregateId_1.AggregateId.guardAgainstInvalidId(id, propertyName);
     }
     /**
      * Valida la referencia de segmento corporativo.
@@ -161,7 +161,7 @@ class CorporateCarbonFootprintSegmentConfigurationReferences extends ValueObject
             throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.name`, 'string', typeof reference.name);
         }
         String_1.String.guardAgainstEmptyValue(reference.id, `${propertyName}.id`);
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(reference.id, `${propertyName}.id`);
+        AggregateId_1.AggregateId.guardAgainstInvalidId(reference.id, `${propertyName}.id`);
         String_1.String.guardAgainstEmptyValue(reference.code, `${propertyName}.code`);
         Code_1.Code.guardAgainstInvalidCode(reference.code);
         String_1.String.guardAgainstEmptyValue(reference.name, `${propertyName}.name`);

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

@@ -73,7 +73,7 @@ class CorporateConfigurationCarbonFootprintSegmentReference extends ObjectValueO
      */
     static guardAgainstInvalidId(id) {
         String_1.String.guardAgainstEmptyValue(id, 'id');
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(id, 'id');
+        AggregateId_1.AggregateId.guardAgainstInvalidId(id, 'id');
     }
     /**
      * Valida el código del segmento corporativo.

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

@@ -73,7 +73,7 @@ class CorporateConfigurationCarbonFootprintSubsegmentReference extends ObjectVal
      */
     static guardAgainstInvalidId(id) {
         String_1.String.guardAgainstEmptyValue(id, 'id');
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(id, 'id');
+        AggregateId_1.AggregateId.guardAgainstInvalidId(id, 'id');
     }
     /**
      * Valida el código del subsegmento corporativo.

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

@@ -64,7 +64,7 @@ class EmissionCalculationFormulaReference extends ObjectValueObject_1.ObjectValu
     }
     static guardAgainstInvalidId(id) {
         String_1.String.guardAgainstEmptyValue(id, 'id');
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(id, 'id');
+        AggregateId_1.AggregateId.guardAgainstInvalidId(id, 'id');
     }
     /**
      * Valida el código de la fórmula de cálculo de emisiones usando las validaciones de Code.

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

@@ -82,7 +82,7 @@ class EmissionCalculationReference extends ObjectValueObject_1.ObjectValueObject
     }
     static guardAgainstInvalidId(id) {
         String_1.String.guardAgainstEmptyValue(id, 'id');
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(id, 'id');
+        AggregateId_1.AggregateId.guardAgainstInvalidId(id, 'id');
     }
     /**
      * Valida la referencia de activity data submission.

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

@@ -67,7 +67,7 @@ class EmissionFactorReference extends ObjectValueObject_1.ObjectValueObject {
      */
     static guardAgainstInvalidId(id) {
         String_1.String.guardAgainstEmptyValue(id, 'id');
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(id, 'id');
+        AggregateId_1.AggregateId.guardAgainstInvalidId(id, 'id');
     }
     /**
      * Valida el código del factor de emisión.

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

@@ -67,7 +67,7 @@ class EventEditionConfigurationCarbonFootprintSubsegmentReference extends Object
      */
     static guardAgainstInvalidId(id) {
         String_1.String.guardAgainstEmptyValue(id, 'id');
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(id, 'id');
+        AggregateId_1.AggregateId.guardAgainstInvalidId(id, 'id');
     }
     /**
      * Valida el código de subsegmento usando las validaciones de Code.

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

@@ -105,7 +105,7 @@ class EventEditionConfigurationCarbonFootprintSubsegmentReferences extends Value
      */
     static guardAgainstInvalidSubsegmentId(id, propertyName) {
         String_1.String.guardAgainstEmptyValue(id, propertyName);
-        AggregateId_1.AggregateId.guardAgainstInvalidSemanticId(id, propertyName);
+        AggregateId_1.AggregateId.guardAgainstInvalidId(id, propertyName);
     }
     /**
      * Valida el código de subsegmento usando las validaciones de Code.