Pattern for UUID v7 with Guid-wrapping Value Objects (+ feature suggestion)

[KaineVarley]

Hi Steve,

First off - great library! We're migrating ~15 hand-rolled record value objects to Vogen in a .NET 10 / EF Core 10 project and it's a huge improvement.

We hit an interesting situation with Customizations.AddFactoryMethodForGuids that I wanted to share in case others encounter it, plus a potential enhancement idea.

The situation

Our project uses UUID v7 (Guid.CreateVersion7()) for all identifier generation - it gives us time-ordered, index-friendly GUIDs in our Azure SQL database. This was a deliberate migration from Guid.NewGuid() (UUID v4).

The AddFactoryMethodForGuids customisation generates FromNewGuid() which (as far as we can tell from the generated code) calls Guid.NewGuid() internally - producing UUID v4. Enabling it in our project would silently regress our UUID v7 migration.

Our pattern

We chose not to enable AddFactoryMethodForGuids and instead added a custom static factory method to each Guid-wrapping VO:

[ValueObject<Guid>]
public partial struct OrderId
{
    /// <summary>Creates a new OrderId with a UUID v7 (time-ordered) identifier.</summary>
    public static OrderId New() => From(Guid.CreateVersion7());
}

This works well because:

• Flows through Vogen's From(), so all validation is preserved
• Partial struct makes it trivially easy to add
• Self-documenting - callers use OrderId.New() which is clean and intention-revealing
• No risk of accidentally calling a v4-generating method

Feature suggestion

Would it be worth adding a Customizations.AddFactoryMethodForVersion7Guids option that generates FromNewGuid() using Guid.CreateVersion7() instead of Guid.NewGuid()?

Since Guid.CreateVersion7() is available from .NET 9+, this could be conditionally generated based on target framework. UUID v7 adoption is growing rapidly for database primary keys, so this might help a lot of users.

Alternatively, a more flexible approach could be a Customizations.AddFactoryMethodForGuids that accepts a configuration for which Guid creation method to use.

Either way, the manual New() pattern above works fine - just thought it might be useful to others!

Thanks for Vogen - it's a genuinely excellent library.