create-value-object

To create an immutable value object in TypeScript, use a private constructor with a static create() factory method and enforce Guard-based validation. This ensures no setters are exposed, only getters, allowing safe sharing across modules.

A value object in domain-driven design models concepts without identity, relying instead on value-based equality. Two instances are equal if their values match, making them immutable and safe to share within the domain layer.

Use a value object instead of an entity when modeling domain concepts without identity, such as Email, Money, or Address. Value objects enforce immutability and value-based equality, enabling safe composition and predictable behavior across modules.

No, this value object pattern enforces no framework dependencies. It relies entirely on native TypeScript patterns like private constructors and static factory methods, keeping your domain layer isolated and predictable.

To validate data when creating a domain value object, use a static create() factory method with Guard-based validation. This guided creation process ensures invalid data never produces an instance, maintaining strict domain invariants.