Revisión general

apps/server/src/index.ts

@@ -2,6 +2,7 @@ import { logger } from "@/lib/logger";
 import { DateTime } from "luxon";
 import http from "node:http";
 import os from "node:os";
+import * as z from "zod/v4";
 import { createApp } from "./app";
 import { ENV } from "./config";
 import { tryConnectToDatabase } from "./config/database";
@@ -12,6 +13,8 @@ import { registerModules } from "./register-modules";
 
 const API_BASE_PATH = "/api/v1";
 
+z.config(z.locales.es());
+
 // Guardamos información del estado del servidor
 export const currentState = {
   launchedAt: DateTime.now(),

modules/core/src/api/domain/errors/duplicate-entity-error.ts

@@ -1,4 +1,4 @@
-import { DomainError } from "./domain-error";
+import { DomainError } from "@repo/rdx-ddd";
 
 export class DuplicateEntityError extends DomainError {
   constructor(entity: string, field: string, value: string, options?: ErrorOptions) {

modules/core/src/api/domain/errors/entity-not-found-error.ts

@@ -1,4 +1,4 @@
-import { DomainError } from "./domain-error";
+import { DomainError } from "@repo/rdx-ddd";
 
 export class EntityNotFoundError extends DomainError {
   constructor(entity: string, field: string, value: any, options?: ErrorOptions) {

modules/core/src/api/domain/errors/index.ts

@@ -1,5 +1,2 @@
-export * from "./domain-error";
-export * from "./domain-validation-error";
 export * from "./duplicate-entity-error";
 export * from "./entity-not-found-error";
-export * from "./validation-error-collection";

modules/core/src/api/helpers/index.ts

@@ -1 +1 @@
-export * from "./extract-or-push-error";
+

modules/core/src/api/infrastructure/database/transaction-manager.ts

@@ -78,7 +78,7 @@ export abstract class TransactionManager implements ITransactionManager {
       await this.rollback();
       const error = err as Error;
       this.logger.error(`❌ Transaction rolled back due to error: ${error.message}`, {
-        stack: error.stack,
+        //stack: error.stack,
         label: "TransactionManager.start",
       });
       throw error;

modules/core/src/api/infrastructure/express/api-error-mapper.ts

@@ -13,13 +13,16 @@
 
 import {
   DomainValidationError,
-  DuplicateEntityError,
-  EntityNotFoundError,
   ValidationErrorCollection,
   isDomainValidationError,
+  isValidationErrorCollection,
+} from "@repo/rdx-ddd";
+
+import {
+  DuplicateEntityError,
+  EntityNotFoundError,
   isDuplicateEntityError,
   isEntityNotFoundError,
-  isValidationErrorCollection,
 } from "../../domain";
 import { isInfrastructureRepositoryError, isInfrastructureUnavailableError } from "../errors";
 import {

modules/core/src/api/infrastructure/sequelize/sequelize-error-translator.ts

@@ -1,3 +1,4 @@
+import { DomainValidationError, ValidationErrorCollection } from "@repo/rdx-ddd";
 import {
   ConnectionError,
   DatabaseError,
@@ -5,12 +6,7 @@ import {
   ValidationError as SequelizeValidationError,
   UniqueConstraintError,
 } from "sequelize";
-import {
+import { DuplicateEntityError, EntityNotFoundError } from "../../domain";
-  DomainValidationError,
-  DuplicateEntityError,
-  EntityNotFoundError,
-  ValidationErrorCollection,
-} from "../../domain";
 import { InfrastructureRepositoryError } from "../errors/infrastructure-repository-error";
 import { InfrastructureUnavailableError } from "../errors/infrastructure-unavailable-error";
 

modules/core/src/api/infrastructure/sequelize/sequelize-transaction-manager.ts

@@ -69,7 +69,7 @@ export class SequelizeTransactionManager extends TransactionManager {
     } catch (err) {
       const error = err as Error;
       this.logger.error(`❌ Transaction rolled back due to error: ${error.message}`, {
-        stack: error.stack,
+        //stack: error.stack,
         label: "SequelizeTransactionManager.complete",
       });
       throw error;

modules/core/tsconfig.json

@@ -28,6 +28,6 @@
     "noFallthroughCasesInSwitch": true,
     "noUncheckedSideEffectImports": true
   },
-  "include": ["src"],
+  "include": ["src", "../../packages/rdx-ddd/src/helpers/extract-or-push-error.ts"],
   "exclude": ["node_modules"]
 }

modules/customer-invoices/src/api/application/helpers/extract-or-push-error.ts

@@ -1,45 +0,0 @@
-import { DomainValidationError, ValidationErrorDetail } from "@erp/core/api";
-import { Result } from "@repo/rdx-utils";
-
-/**
- * Extrae un valor de un Result si es válido.
- * Si es un fallo, agrega un ValidationErrorDetail al array proporcionado.
- * @param result - El resultado a evaluar.
- * @param path - La ruta del error para el detalle de validación.
- * @param errors - El array donde se agregarán los errores de validación.
- * @returns El valor extraído si el resultado es exitoso, o undefined si es un fallo.
- * @template T - El tipo de dato esperado en el resultado exitoso.
- * @throws {Error} Si el resultado es un fallo y no es una instancia de DomainValidationError.
- * @example
- * const result = Result.ok(42);
- * const value = extractOrPushError(result, 'some.path', []);
- * console.log(value); // 42
- * const errorResult = Result.fail(new Error('Something went wrong'));
- * const value = extractOrPushError(errorResult, 'some.path', []);
- * console.log(value); // undefined
- * // errors will contain [{ path: 'some.path', message: 'Something went wrong' }]
- * 
- * @see Result
- * @see DomainValidationError
- * @see ValidationErrorDetail
-
- */
-export function extractOrPushError<T>(
-  result: Result<T, Error>,
-  path: string,
-  errors: ValidationErrorDetail[]
-): T | undefined {
-  if (result.isFailure) {
-    const error = result.error;
-
-    if (error instanceof DomainValidationError) {
-      errors.push({ path, message: error.detail });
-    } else {
-      errors.push({ path, message: error.message });
-    }
-
-    return undefined;
-  }
-
-  return result.data;
-}

modules/customer-invoices/src/api/application/helpers/map-dto-to-customer-invoice-items-props.ts

@@ -1,10 +1,8 @@
-import { ValidationErrorCollection, ValidationErrorDetail } from "@erp/core/api";
+import { ValidationErrorCollection, ValidationErrorDetail } from "@repo/rdx-ddd";
-import { CreateCustomerInvoiceCommandDTO } from "@erp/customer-invoices/common/dto";
 import { Result } from "@repo/rdx-utils";
 import {
   CustomerInvoiceItem,
   CustomerInvoiceItemDescription,
-  CustomerInvoiceItemQuantity,
   ItemAmount,
   ItemDiscount,
 } from "../../domain";

modules/customer-invoices/src/api/application/use-cases/create/map-dto-to-create-customer-invoice-props.ts

@@ -1,19 +1,16 @@
 import { JsonTaxCatalogProvider } from "@erp/core";
-import {
+import { Tax, Taxes } from "@erp/core/api";
-  DomainError,
-  Tax,
-  Taxes,
-  ValidationErrorCollection,
-  ValidationErrorDetail,
-  extractOrPushError,
-} from "@erp/core/api";
 import {
   CurrencyCode,
+  DomainError,
   LanguageCode,
   Percentage,
   TextValue,
   UniqueID,
   UtcDate,
+  ValidationErrorCollection,
+  ValidationErrorDetail,
+  extractOrPushError,
   maybeFromNullableVO,
 } from "@repo/rdx-ddd";
 import { Result } from "@repo/rdx-utils";

modules/customer-invoices/src/api/domain/errors/customer-invoice-id-already-exits-error.ts

@@ -1,7 +1,7 @@
 // Ejemplo: regla específica para Billing → InvoiceIdAlreadyExistsError
 // (si defines un error más ubicuo dentro del BC con su propia clase)
 
-import { DomainError } from "@erp/core/api";
+import { DomainError } from "@repo/rdx-ddd";
 
 // Suponemos que existe esta clase en tu dominio de Billing:
 export class CustomerInvoiceIdAlreadyExistsError extends DomainError {

modules/customer-invoices/src/api/infrastructure/mappers/domain/customer-invoice-item.mapper.ts

@@ -1,12 +1,11 @@
+import { ISequelizeDomainMapper, MapperParamsType, SequelizeDomainMapper } from "@erp/core/api";
 import {
-  ISequelizeDomainMapper,
+  UniqueID,
-  MapperParamsType,
-  SequelizeDomainMapper,
   ValidationErrorCollection,
   ValidationErrorDetail,
   extractOrPushError,
-} from "@erp/core/api";
+  maybeFromNullableVO,
-import { UniqueID, maybeFromNullableVO } from "@repo/rdx-ddd";
+} from "@repo/rdx-ddd";
 import { Result } from "@repo/rdx-utils";
 import { InferCreationAttributes } from "sequelize";
 import {

modules/customer-invoices/src/api/infrastructure/mappers/domain/customer-invoice.mapper.ts

@@ -1,11 +1,4 @@
-import {
+import { ISequelizeDomainMapper, MapperParamsType, SequelizeDomainMapper } from "@erp/core/api";
-  ISequelizeDomainMapper,
-  MapperParamsType,
-  SequelizeDomainMapper,
-  ValidationErrorCollection,
-  ValidationErrorDetail,
-  extractOrPushError,
-} from "@erp/core/api";
 import {
   CurrencyCode,
   LanguageCode,
@@ -13,6 +6,9 @@ import {
   TextValue,
   UniqueID,
   UtcDate,
+  ValidationErrorCollection,
+  ValidationErrorDetail,
+  extractOrPushError,
   maybeFromNullableVO,
 } from "@repo/rdx-ddd";
 import { Maybe, Result } from "@repo/rdx-utils";

modules/customer-invoices/src/api/infrastructure/mappers/domain/invoice-recipient.mapper.ts

@@ -6,15 +6,13 @@ import {
   Province,
   Street,
   TINNumber,
-  maybeFromNullableVO,
-} from "@repo/rdx-ddd";
-
-import {
-  MapperParamsType,
   ValidationErrorCollection,
   ValidationErrorDetail,
   extractOrPushError,
-} from "@erp/core/api";
+  maybeFromNullableVO,
+} from "@repo/rdx-ddd";
+
+import { MapperParamsType } from "@erp/core/api";
 import { Maybe, Result } from "@repo/rdx-utils";
 import { CustomerInvoiceProps, InvoiceRecipient } from "../../../domain";
 import { CustomerInvoiceModel } from "../../sequelize";

modules/customer-invoices/src/api/infrastructure/mappers/domain/item-taxes.mapper.ts

@@ -1,12 +1,10 @@
 import { JsonTaxCatalogProvider } from "@erp/core";
+import { MapperParamsType, SequelizeDomainMapper, Tax } from "@erp/core/api";
 import {
-  MapperParamsType,
-  SequelizeDomainMapper,
-  Tax,
   ValidationErrorCollection,
   ValidationErrorDetail,
   extractOrPushError,
-} from "@erp/core/api";
+} from "@repo/rdx-ddd";
 import { Result } from "@repo/rdx-utils";
 import { ItemTax } from "../../../domain";
 import {

modules/customer-invoices/src/api/infrastructure/mappers/domain/taxes.mapper.ts

@@ -1,12 +1,11 @@
 import { JsonTaxCatalogProvider } from "@erp/core";
+import { MapperParamsType, SequelizeDomainMapper, Tax } from "@erp/core/api";
 import {
-  MapperParamsType,
-  SequelizeDomainMapper,
-  Tax,
   ValidationErrorCollection,
   ValidationErrorDetail,
   extractOrPushError,
-} from "@erp/core/api";
+} from "@repo/rdx-ddd";
+
 import { Result } from "@repo/rdx-utils";
 import { CustomerInvoiceProps } from "../../../domain";
 import { InvoiceTax } from "../../../domain/entities/invoice-taxes";

modules/customer-invoices/src/api/infrastructure/mappers/queries/customer-invoice.list.mapper.ts

@@ -1,11 +1,11 @@
+import { ISequelizeQueryMapper, MapperParamsType, SequelizeQueryMapper } from "@erp/core/api";
+
 import {
-  ISequelizeQueryMapper,
-  MapperParamsType,
-  SequelizeQueryMapper,
   ValidationErrorCollection,
   ValidationErrorDetail,
   extractOrPushError,
-} from "@erp/core/api";
+} from "@repo/rdx-ddd";
+
 import {
   CurrencyCode,
   LanguageCode,

modules/customers/src/api/application/use-cases/create/map-dto-to-create-customer-props.ts

@@ -1,13 +1,8 @@
-import {
-  DomainError,
-  ValidationErrorCollection,
-  ValidationErrorDetail,
-  extractOrPushError,
-} from "@erp/core/api";
 import {
   City,
   Country,
   CurrencyCode,
+  DomainError,
   EmailAddress,
   LanguageCode,
   Name,
@@ -21,6 +16,9 @@ import {
   TextValue,
   URLAddress,
   UniqueID,
+  ValidationErrorCollection,
+  ValidationErrorDetail,
+  extractOrPushError,
   maybeFromNullableVO,
 } from "@repo/rdx-ddd";
 import { Collection, Result, isNullishOrEmpty } from "@repo/rdx-utils";

modules/customers/src/api/application/use-cases/update/map-dto-to-update-customer-props.ts

@@ -1,9 +1,5 @@
-import {
+import { DomainError, ValidationErrorCollection, ValidationErrorDetail } from "@repo/rdx-ddd";
-  DomainError,
+
-  ValidationErrorCollection,
-  ValidationErrorDetail,
-  extractOrPushError,
-} from "@erp/core/api";
 import {
   City,
   Country,
@@ -23,8 +19,6 @@ import {
   maybeFromNullableVO,
 } from "@repo/rdx-ddd";
 import { Collection, Result, isNullishOrEmpty, toPatchField } from "@repo/rdx-utils";
-import { UpdateCustomerRequestDTO } from "../../../common/dto";
-import { CustomerPatchProps } from "../../domain";
 
 /**
  * mapDTOToUpdateCustomerPatchProps

modules/customers/src/api/infrastructure/mappers/domain/customer.mapper.ts

@@ -1,11 +1,6 @@
-import {
+import { ValidationErrorCollection, ValidationErrorDetail } from "@repo/rdx-ddd";
-  ISequelizeDomainMapper,
+
-  MapperParamsType,
+import { ISequelizeDomainMapper, MapperParamsType, SequelizeDomainMapper } from "@erp/core/api";
-  SequelizeDomainMapper,
-  ValidationErrorCollection,
-  ValidationErrorDetail,
-  extractOrPushError,
-} from "@erp/core/api";
 import {
   City,
   Country,
@@ -23,6 +18,7 @@ import {
   TextValue,
   URLAddress,
   UniqueID,
+  extractOrPushError,
   maybeFromNullableVO,
   toNullable,
 } from "@repo/rdx-ddd";

modules/customers/src/api/infrastructure/mappers/queries/customer.list.mapper.ts

@@ -1,3 +1,5 @@
+import { ValidationErrorCollection, ValidationErrorDetail } from "@repo/rdx-ddd";
+
 import {
   City,
   Country,
@@ -14,17 +16,11 @@ import {
   TextValue,
   URLAddress,
   UniqueID,
+  extractOrPushError,
   maybeFromNullableVO,
 } from "@repo/rdx-ddd";
 
-import {
+import { ISequelizeQueryMapper, MapperParamsType, SequelizeQueryMapper } from "@erp/core/api";
-  ISequelizeQueryMapper,
-  MapperParamsType,
-  SequelizeQueryMapper,
-  ValidationErrorCollection,
-  ValidationErrorDetail,
-  extractOrPushError,
-} from "@erp/core/api";
 
 import { Maybe, Result } from "@repo/rdx-utils";
 import { CustomerStatus } from "../../../domain";

modules/customers/tsconfig.json

@@ -28,6 +28,6 @@
     "noFallthroughCasesInSwitch": true,
     "noUncheckedSideEffectImports": true
   },
-  "include": ["src", "../core/src/api/helpers/extract-or-push-error.ts"],
+  "include": ["src", "../../packages/rdx-ddd/src/helpers/extract-or-push-error.ts"],
   "exclude": ["node_modules"]
 }

packages/rdx-ddd/src/errors/domain-validation-error.ts

@@ -35,12 +35,20 @@ export class DomainValidationError extends DomainError {
   }
 
   // Constructores rápidos
-  static required(field: string, options?: ErrorOptions) {
+  static requiredValue(field: string, options?: ErrorOptions) {
-    return new DomainValidationError("REQUIRED", field, "cannot be empty", options);
+    return new DomainValidationError("REQUIRED_VALUE", field, "cannot be empty", options);
   }
   static invalidFormat(field: string, detail = "invalid format", options?: ErrorOptions) {
     return new DomainValidationError("INVALID_FORMAT", field, detail, options);
   }
+  static invalidValue(
+    field: string,
+    value: unknown,
+    detail = "invalid value",
+    options?: ErrorOptions
+  ) {
+    return new DomainValidationError("INVALID_VALUE", field, detail, { ...options, cause: value });
+  }
 
   // Proyección útil para Problem+JSON o colecciones
   toDetail() {

packages/rdx-ddd/src/errors/index.ts

@@ -0,0 +1,3 @@
+export * from "./domain-error";
+export * from "./domain-validation-error";
+export * from "./validation-error-collection";

packages/rdx-ddd/src/errors/validation-error-collection.ts

@@ -18,8 +18,9 @@
 import { DomainError } from "./domain-error";
 
 export interface ValidationErrorDetail {
-  path: string; // ejemplo: "lines[1].unitPrice.amount"
+  path?: string; // ejemplo: "lines[1].unitPrice.amount"
   message: string; // ejemplo: "Amount must be a positive number",
+  value?: unknown; // valor inválido opcional
 }
 
 /**

packages/rdx-ddd/src/helpers/extract-or-push-error.ts

@@ -1,5 +1,10 @@
-import { DomainValidationError, ValidationErrorDetail } from "@erp/core/api";
 import { Result } from "@repo/rdx-utils";
+import {
+  DomainValidationError,
+  ValidationErrorDetail,
+  isDomainValidationError,
+  isValidationErrorCollection,
+} from "../errors";
 
 /**
  * Extrae un valor de un Result si es válido.
@@ -32,8 +37,11 @@ export function extractOrPushError<T>(
   if (result.isFailure) {
     const error = result.error;
 
-    if (error instanceof DomainValidationError) {
+    if (isValidationErrorCollection(error)) {
-      errors.push({ path, message: error.detail });
+      // Agrega todos los detalles de error al array proporcionado
+      errors.push(...error.details);
+    } else if (isDomainValidationError(error)) {
+      errors.push({ path, message: error.detail, value: error.cause?.toString() });
     } else {
       errors.push({ path, message: error.message });
     }

packages/rdx-ddd/src/helpers/index.ts

@@ -1 +1,3 @@
+export * from "./extract-or-push-error";
 export * from "./normalizers";
+export * from "./zod-validator-error-traslator";

packages/rdx-ddd/src/helpers/zod-validator-error-traslator.ts

@@ -0,0 +1,18 @@
+import { ZodError } from "zod/v4";
+import { ValidationErrorCollection, ValidationErrorDetail } from "../errors";
+
+export function translateZodValidationError<T>(
+  message: string,
+  zodError: ZodError<T>,
+  errorValue?: unknown
+) {
+  const errors: ValidationErrorDetail[] = [];
+  for (const issue of zodError.issues) {
+    errors.push({
+      message: issue.message,
+      path: issue.path.join("."),
+      value: errorValue ?? issue.input,
+    });
+  }
+  return new ValidationErrorCollection(message, errors);
+}

packages/rdx-ddd/src/index.ts

@@ -1,6 +1,7 @@
 export * from "./aggregate-root";
 export * from "./aggregate-root-repository.interface";
 export * from "./domain-entity";
+export * from "./errors";
 export * from "./events/domain-event.interface";
 export * from "./helpers";
 export * from "./specification";

packages/rdx-ddd/src/value-objects/city.ts

@@ -1,5 +1,6 @@
 import { Result } from "@repo/rdx-utils";
 import * as z from "zod/v4";
+import { translateZodValidationError } from "../helpers";
 import { ValueObject } from "./value-object";
 
 interface CityProps {
@@ -23,7 +24,7 @@ export class City extends ValueObject<CityProps> {
     const valueIsValid = City.validate(value);
 
     if (!valueIsValid.success) {
-      return Result.fail(new Error(valueIsValid.error.issues[0].message));
+      return Result.fail(translateZodValidationError("City creation failed", valueIsValid.error));
     }
     return Result.ok(new City({ value }));
   }

packages/rdx-ddd/src/value-objects/country.ts

@@ -1,5 +1,6 @@
 import { Result } from "@repo/rdx-utils";
 import * as z from "zod/v4";
+import { translateZodValidationError } from "../helpers";
 import { ValueObject } from "./value-object";
 
 interface CountryProps {
@@ -23,7 +24,9 @@ export class Country extends ValueObject<CountryProps> {
     const valueIsValid = Country.validate(value);
 
     if (!valueIsValid.success) {
-      return Result.fail(new Error(valueIsValid.error.issues[0].message));
+      return Result.fail(
+        translateZodValidationError("Country creation failed", valueIsValid.error)
+      );
     }
     return Result.ok(new Country({ value }));
   }

packages/rdx-ddd/src/value-objects/currency-code.ts

@@ -1,5 +1,6 @@
 import { Result } from "@repo/rdx-utils";
 import * as z from "zod/v4";
+import { translateZodValidationError } from "../helpers";
 import { ValueObject } from "./value-object";
 
 interface CurrencyCodeProps {
@@ -33,7 +34,9 @@ export class CurrencyCode extends ValueObject<CurrencyCodeProps> {
     const valueIsValid = CurrencyCode.validate(value);
 
     if (!valueIsValid.success) {
-      return Result.fail(new Error(valueIsValid.error.issues[0].message));
+      return Result.fail(
+        translateZodValidationError("CurrencyCode creation failed", valueIsValid.error)
+      );
     }
     return Result.ok(new CurrencyCode({ value: valueIsValid.data }));
   }

packages/rdx-ddd/src/value-objects/email-address.ts

@@ -1,5 +1,6 @@
 import { Result } from "@repo/rdx-utils";
 import * as z from "zod/v4";
+import { translateZodValidationError } from "../helpers";
 import { ValueObject } from "./value-object";
 
 interface EmailAddressProps {
@@ -11,7 +12,9 @@ export class EmailAddress extends ValueObject<EmailAddressProps> {
     const valueIsValid = EmailAddress.validate(value);
 
     if (!valueIsValid.success) {
-      return Result.fail(new Error(valueIsValid.error.issues[0].message));
+      return Result.fail(
+        translateZodValidationError("EmailAddress creation failed", valueIsValid.error)
+      );
     }
 
     return Result.ok(new EmailAddress({ value: valueIsValid.data }));

packages/rdx-ddd/src/value-objects/language-code.ts

@@ -1,5 +1,6 @@
 import { Result } from "@repo/rdx-utils";
 import * as z from "zod/v4";
+import { translateZodValidationError } from "../helpers";
 import { ValueObject } from "./value-object";
 
 interface LanguageCodeProps {
@@ -33,7 +34,9 @@ export class LanguageCode extends ValueObject<LanguageCodeProps> {
     const valueIsValid = LanguageCode.validate(value);
 
     if (!valueIsValid.success) {
-      return Result.fail(new Error(valueIsValid.error.issues[0].message));
+      return Result.fail(
+        translateZodValidationError("LanguageCode creation failed", valueIsValid.error)
+      );
     }
     return Result.ok(new LanguageCode({ value: valueIsValid.data }));
   }

packages/rdx-ddd/src/value-objects/name.ts

@@ -1,5 +1,6 @@
 import { Result } from "@repo/rdx-utils";
 import * as z from "zod/v4";
+import { translateZodValidationError } from "../helpers";
 import { ValueObject } from "./value-object";
 
 interface NameProps {
@@ -21,7 +22,7 @@ export class Name extends ValueObject<NameProps> {
     const valueIsValid = Name.validate(value);
 
     if (!valueIsValid.success) {
-      return Result.fail(new Error(valueIsValid.error.issues[0].message));
+      return Result.fail(translateZodValidationError("Name creation failed", valueIsValid.error));
     }
     return Result.ok(new Name({ value }));
   }

packages/rdx-ddd/src/value-objects/percentage.ts

@@ -1,5 +1,6 @@
 import { Result } from "@repo/rdx-utils";
 import * as z from "zod/v4";
+import { translateZodValidationError } from "../helpers";
 import { ValueObject } from "./value-object";
 
 const DEFAULT_SCALE = 2;
@@ -42,9 +43,12 @@ export class Percentage extends ValueObject<PercentageProps> {
   static create(props: { value: number; scale?: number }): Result<Percentage> {
     const { value, scale = Percentage.DEFAULT_SCALE } = props;
 
-    const validationResult = Percentage.validate({ value, scale });
+    const valueIsValid = Percentage.validate({ value, scale });
-    if (!validationResult.success) {
+
-      return Result.fail(new Error(validationResult.error.issues.map((e) => e.message).join(", ")));
+    if (!valueIsValid.success) {
+      return Result.fail(
+        translateZodValidationError("Percentage creation failed", valueIsValid.error)
+      );
     }
 
     // Cálculo del valor real del porcentaje

packages/rdx-ddd/src/value-objects/phone-number.ts

@@ -1,6 +1,7 @@
 import { Result } from "@repo/rdx-utils";
 import { isPossiblePhoneNumber, parsePhoneNumberWithError } from "libphonenumber-js";
 import * as z from "zod/v4";
+import { translateZodValidationError } from "../helpers";
 import { ValueObject } from "./value-object";
 
 interface PhoneNumberProps {
@@ -38,14 +39,18 @@ export class PhoneNumber extends ValueObject<PhoneNumberProps> {
         }
       })*/
 
-    return schema.safeParse(value);
+    return schema.safeParse(value, {
+      reportInput: true,
+    });
   }
 
   static create(value: string): Result<PhoneNumber> {
     const valueIsValid = PhoneNumber.validate(value);
 
     if (!valueIsValid.success) {
-      return Result.fail(new Error(valueIsValid.error.issues[0].message));
+      return Result.fail(
+        translateZodValidationError("PhoneNumber creation failed", valueIsValid.error)
+      );
     }
 
     return Result.ok(new PhoneNumber({ value: valueIsValid.data }));

packages/rdx-ddd/src/value-objects/postal-code.ts

@@ -1,5 +1,6 @@
 import { Result } from "@repo/rdx-utils";
 import * as z from "zod/v4";
+import { translateZodValidationError } from "../helpers";
 import { ValueObject } from "./value-object";
 
 interface PostalCodeProps {
@@ -31,7 +32,9 @@ export class PostalCode extends ValueObject<PostalCodeProps> {
     const valueIsValid = PostalCode.validate(value);
 
     if (!valueIsValid.success) {
-      return Result.fail(new Error(valueIsValid.error.issues[0].message));
+      return Result.fail(
+        translateZodValidationError("PostalCode creation failed", valueIsValid.error)
+      );
     }
     return Result.ok(new PostalCode({ value: valueIsValid.data }));
   }

packages/rdx-ddd/src/value-objects/province.ts

@@ -1,5 +1,6 @@
 import { Result } from "@repo/rdx-utils";
 import * as z from "zod/v4";
+import { translateZodValidationError } from "../helpers";
 import { ValueObject } from "./value-object";
 
 interface ProvinceProps {
@@ -23,7 +24,9 @@ export class Province extends ValueObject<ProvinceProps> {
     const valueIsValid = Province.validate(value);
 
     if (!valueIsValid.success) {
-      return Result.fail(new Error(valueIsValid.error.issues[0].message));
+      return Result.fail(
+        translateZodValidationError("Province creation failed", valueIsValid.error)
+      );
     }
     return Result.ok(new Province({ value }));
   }

packages/rdx-ddd/src/value-objects/quantity.ts

@@ -1,5 +1,6 @@
 import { Result } from "@repo/rdx-utils";
 import * as z from "zod/v4";
+import { translateZodValidationError } from "../helpers";
 import { ValueObject } from "./value-object";
 
 const DEFAULT_SCALE = 2;
@@ -33,7 +34,7 @@ export class Quantity extends ValueObject<QuantityProps> {
     const checkProps = Quantity.validate(props);
 
     if (!checkProps.success) {
-      return Result.fail(new Error(checkProps.error.issues[0].message));
+      return Result.fail(translateZodValidationError("Quantity creation failed", checkProps.error));
     }
     return Result.ok(new Quantity({ ...(checkProps.data as QuantityProps) }));
   }

packages/rdx-ddd/src/value-objects/slug.ts

@@ -1,5 +1,6 @@
 import { Result } from "@repo/rdx-utils";
 import * as z from "zod/v4";
+import { translateZodValidationError } from "../helpers";
 import { ValueObject } from "./value-object";
 
 interface SlugProps {
@@ -26,7 +27,7 @@ export class Slug extends ValueObject<SlugProps> {
     const valueIsValid = Slug.validate(value);
 
     if (!valueIsValid.success) {
-      return Result.fail(new Error(valueIsValid.error.issues[0].message));
+      return Result.fail(translateZodValidationError("Slug creation failed", valueIsValid.error));
     }
     // biome-ignore lint/style/noNonNullAssertion: <explanation>
     return Result.ok(new Slug({ value: valueIsValid.data! }));

packages/rdx-ddd/src/value-objects/street.ts

@@ -1,5 +1,6 @@
 import { Result } from "@repo/rdx-utils";
 import * as z from "zod/v4";
+import { translateZodValidationError } from "../helpers";
 import { ValueObject } from "./value-object";
 
 interface StreetProps {
@@ -23,7 +24,7 @@ export class Street extends ValueObject<StreetProps> {
     const valueIsValid = Street.validate(value);
 
     if (!valueIsValid.success) {
-      return Result.fail(new Error(valueIsValid.error.issues[0].message));
+      return Result.fail(translateZodValidationError("Street creation failed", valueIsValid.error));
     }
     return Result.ok(new Street({ value }));
   }

packages/rdx-ddd/src/value-objects/tax-code.ts

@@ -1,5 +1,6 @@
 import { Result } from "@repo/rdx-utils";
 import * as z from "zod/v4";
+import { translateZodValidationError } from "../helpers";
 import { ValueObject } from "./value-object";
 
 interface TaxCodeProps {
@@ -30,7 +31,9 @@ export class TaxCode extends ValueObject<TaxCodeProps> {
     const valueIsValid = TaxCode.validate(value);
 
     if (!valueIsValid.success) {
-      return Result.fail(new Error(valueIsValid.error.issues[0].message));
+      return Result.fail(
+        translateZodValidationError("TaxCode creation failed", valueIsValid.error)
+      );
     }
     // biome-ignore lint/style/noNonNullAssertion: <explanation>
     return Result.ok(new TaxCode({ value: valueIsValid.data! }));

packages/rdx-ddd/src/value-objects/text-value.ts

@@ -1,5 +1,6 @@
 import { Result } from "@repo/rdx-utils";
 import * as z from "zod/v4";
+import { translateZodValidationError } from "../helpers";
 import { ValueObject } from "./value-object";
 
 interface TextValueProps {
@@ -24,7 +25,9 @@ export class TextValue extends ValueObject<TextValueProps> {
     const valueIsValid = TextValue.validate(value);
 
     if (!valueIsValid.success) {
-      return Result.fail(new Error(valueIsValid.error.issues[0].message));
+      return Result.fail(
+        translateZodValidationError("TextValue creation failed", valueIsValid.error)
+      );
     }
     return Result.ok(new TextValue({ value }));
   }

packages/rdx-ddd/src/value-objects/tin-number.ts

@@ -1,5 +1,6 @@
 import { Result } from "@repo/rdx-utils";
 import * as z from "zod/v4";
+import { translateZodValidationError } from "../helpers";
 import { ValueObject } from "./value-object";
 
 interface TINNumberProps {
@@ -28,7 +29,9 @@ export class TINNumber extends ValueObject<TINNumberProps> {
     const valueIsValid = TINNumber.validate(value);
 
     if (!valueIsValid.success) {
-      return Result.fail(new Error(valueIsValid.error.issues[0].message));
+      return Result.fail(
+        translateZodValidationError("TINNumber creation failed", valueIsValid.error)
+      );
     }
     return Result.ok(new TINNumber({ value: valueIsValid.data }));
   }

packages/rdx-ddd/src/value-objects/url-address.ts

@@ -1,5 +1,6 @@
 import { Result } from "@repo/rdx-utils";
 import * as z from "zod/v4";
+import { translateZodValidationError } from "../helpers";
 import { ValueObject } from "./value-object";
 
 interface URLAddressProps {
@@ -11,14 +12,28 @@ export class URLAddress extends ValueObject<URLAddressProps> {
     const valueIsValid = URLAddress.validate(value);
 
     if (!valueIsValid.success) {
-      return Result.fail(new Error(valueIsValid.error.issues[0].message));
+      return Result.fail(
+        translateZodValidationError("URLAddress creation failed", valueIsValid.error)
+      );
     }
 
     return Result.ok(new URLAddress({ value: valueIsValid.data }));
   }
 
   private static validate(value: string) {
-    const schema = z.url({ message: "Invalid URL format" });
+    const schema = z.string().refine((value) => {
+      const urlPattern = new RegExp(
+        "^(https?:\\/\\/)?" + // protocolo opcional
+          "((([a-z\\d]([a-z\\d-]*[a-z\\d])*)\\.)+[a-z]{2,}|" + // nombre de dominio
+          "((\\d{1,3}\\.){3}\\d{1,3}))" + // o dirección IP (v4)
+          "(\\:\\d+)?(\\/[-a-z\\d%_.~+]*)*" + // puerto y ruta
+          "(\\?[;&a-z\\d%_.~+=-]*)?" + // query string
+          "(\\#[-a-z\\d_]*)?$",
+        "i" // fragment locator
+      );
+      return urlPattern.test(value);
+    }, "Invalid URL format");
+
     return schema.safeParse(value);
   }
 

packages/rdx-ddd/src/value-objects/utc-date.ts

@@ -1,5 +1,6 @@
 import { Result } from "@repo/rdx-utils";
 import * as z from "zod/v4";
+import { translateZodValidationError } from "../helpers";
 import { ValueObject } from "./value-object";
 
 interface UtcDateProps {
@@ -33,8 +34,9 @@ export class UtcDate extends ValueObject<UtcDateProps> {
    */
   static createFromISO(isoDateString: string): Result<UtcDate, Error> {
     const dateIsValid = UtcDate.validate(isoDateString);
+
     if (!dateIsValid.success) {
-      return Result.fail(new Error(`Invalid UTC date format: ${isoDateString}`));
+      return Result.fail(translateZodValidationError("UtcDate creation failed", dateIsValid.error));
     }
 
     return Result.ok(new UtcDate({ value: isoDateString }));