Summary

Add UUID v7 generation support to the Uuid value object.

This change introduces a dedicated v7() factory method and adds a generic create() factory that now generates UUID v7 by default.

Changes

• add Uuid::v7() in src/Domain/Model/ValueObject/Uuid.php
• add Uuid::create() as the generic factory for new UUIDs
• keep Uuid::v4() available for explicit v4 generation

Context

Main advantages of v7 over v4:

• Better database insert performance
• Less index fragmentation
• Natural sorting by creation time
• Easier debugging and traceability
• Still works well in distributed systems without central coordination

v4 is still fine when you only need simple, fully random identifiers.

Changes:

• refactor: remove 'abstract' access modifier from VOs

Notes:

Before: you must create a child VO class that extend VO class After: you can use parent VO (Ex: StringValueObject) without create child class

feat: add equivalentTo function to collection value object

function is similar to equalTo, but:

• equalTo: two identical collections with different order returned false.
• equivalentTo: two equal collections with different order return true.

fix: remove impossible return type cases

• feat: override all date time factory functions

fix: prevent generate not UTC datetime

This value object was thinking for use UTC as TimeZone standar. However, it allow set other timezone by passing it on "from" factory:

$date = DateTimeValueObject::from('2025-01-10T15:16:11+01:00')

echo $date->format(\DATE_ATOM) ; // result 2025-01-10T15:16:11+01:00

Before this fix, date was transformed to UTC, expected result: 2025-01-10T14:16:11+00:00

• Add date value object #40
• Renamed DateTimeRangeValeObject to DateTimeRangeValueObject and deprecated the first.
• Added value method to Value interface

feat: Add unique id value object

• fix: Keep microseconds in DateTimeValueObject #38

• feat: allow set occurred on datetime format
• refactor: remove aggregate message aggregate uuid support
• refactor: add static return types to factories

• AggregateMessage edited: now aggregate id is a string value object, not uuid required.
• Add deprecation: on "AggregateMessage::fromPayload" $aggregateId should be a AggregateId value object instead of Uuid.

• remove unsafe ValueObject constructors
• phpstand added
• php7.4 compatibility removed
• update return types (adding ": static" to factories)
• add iterator and countable type hint to collection

#31 Updated return type from self to static

v2.3.1

#30 Add missing return types

added: Obtain collection first element

• development dependencies upgraded
• php 8 compatibility added

• Add sort function in CollectionValueObject

Patch deserializers