ddd_value_objects 0.2.0

A collection of reusable Value Objects for Domain-Driven Design in Flutter.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.2.0 - 2025-01-27

Added

• Url Value Object
  • HTTP/HTTPS validation
  • Protocol, domain, path, port extraction
  • Query parameters parsing
  • Fragment (anchor) support
  • Security check (isSecure for HTTPS)
  • Comprehensive validation with 42 tests
• Username Value Object
  • Alphanumeric + underscore validation
  • Configurable length constraints (default 3-20)
  • Automatic lowercase normalization
  • Helper methods (hasUnderscore, hasDigit, isAlphaOnly)
  • 37 comprehensive tests
• EmailAddress enhancements
  • isDisposable - Detects disposable/temporary email domains
  • isBusinessEmail - Distinguishes business vs personal emails
• FullName enhancements
  • initials - Extracts initials from full name (e.g., "Jean Dupont" → "JD")
  • sortName - Formats name for sorting (e.g., "DUPONT, Jean")

Changed

• Improved i18n architecture - All failure messages now centralized in FailureMessages
• Total test coverage increased to 252+ tests

Fixed

• Improved consistency in error message handling across all Value Objects

0.1.0 - 2025-01-20

Added

• Initial release of DDD Value Objects package
• EmailAddress Value Object with RFC 5322 validation
  • Email normalization (lowercase, trim)
  • Domain and local part extraction
  • Comprehensive validation
• Password Value Object with configurable validation
  • Three preset configurations (strong, medium, weak)
  • Custom configuration support
  • Password strength calculation (0-100 scale)
  • Character requirement checks (uppercase, lowercase, digit, special)
• Name Value Objects (FirstName, LastName, FullName)
  • Automatic capitalization (FirstName: "Jean", LastName: "DUPONT")
  • Support for international characters (accents, etc.)
  • Support for hyphens and apostrophes
  • FullName creation from string or parts
• Age Value Object with customizable constraints
  • Default range: 0-150 years
  • Custom min/max age support
  • Helper methods (isMinor, isAdult, isSenior)
  • Age categories (infant, child, teenager, adult, senior)
  • Birth year calculation
• Internationalization (i18n)
  • English and French error messages
  • Easy language switching via FailureMessages.setLanguage()
• Core features
  • Immutable Value Objects
  • Functional error handling with Either from dartz
  • Proper equality using equatable
  • Comprehensive validation failures