data-mapping

What problem does it solve?

Data mapping patterns enable transforming raw API responses into strongly-typed internal models, enforcing contracts and reducing runtime errors during data ingestion.

Core Features & Use Cases

• Ensure required fields with consistent validation using ensureProperties()
• Normalize optional fields with optional() to preserve legitimate falsy values
• Convert and map primitive types with map() for DateTime, UUID, URL, and Email
• Handle nested objects with mapWith() and dedicated helper mappers
• Convert snake_case in API payloads to camelCase in code
• Map enums with toEnum() for robust type safety in API integration
• Support arrays by mapping items individually and applying appropriate type transforms

Quick Start

Provide a raw API response and request a strongly-typed model using to<Model> mappers to generate the internal representation.