@dynamic-mapper/mapper NPM

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.

Example

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'
// }