DynamicMapper
DynamicMapper is a dependency free library that provides support for object to object mapping to JavaScript for both browser and node.js environment. Inspired by AutoMapper.
For best experience, use DynamicMapper together with TypeScript.
Installation
npm i @dynamic-mapper/mapper --save
Documentation
Complete documentation available here.
Motivation
Take a UI application where data are consumed in a form of Response DTO interface that needs to be transformed to Domain interface that is
later transformed into a UI view (i.e. Angular Reactive Form value). Modified view then needs to be transformed back to Domain and
this updated domain object should be send back to the server in form of Request DTO. Pretty tedious to write those mapping in an imperative
way for each individual domain object.
Usage
import { MappingPair, MapperConfiguration } from '@dynamic-mapper/mapper';
interface CustomerDto {
firstName: string;
lastName: string;
}
interface Customer {
firstName: string;
lastName: string;
fullName: string;
}
const CustomerDtoToCustomer = new MappingPair<CustomerDto, Customer>();
const configuration = new MapperConfiguration(cfg => {
cfg.createAutoMap(CustomerDtoToCustomer, {
fullName: opt => opt.mapFrom(src => `${src.firstName} ${src.lastName}`)
});
});
const mapper = configuration.createMapper();
const customerDto: CustomerDto = {
firstName: 'John',
lastName: 'Doe'
};
const customer = mapper.map(CustomerDtoToCustomer, customerDto);
// {
// firstName: 'John',
// lastName: 'Doe',
// fullName: 'John Doe'
// }