Mapper - Object to object mapper in Typescript

Inspired by Automapper

Warning: This is NOT a complete reimplementation of Automapper.

What is this

This library provides an API to map an object into another object, following previously set rules.
It is designed with redux's reducers in mind, so it is a perfect fit when used as application's state incremental modifier.
It provides immutability, nested mapping capabilities and higly customizable configuration interfaces.

Supports:
+ Immutability
+ Nested mapping
+ Redudant mapping
+ Override of pre-existing rules to behave differently in runtime (edge cases)
+ Array mapping

*

How to

$3

Install

> yarn add @wufe/mapper

or

> npm i --save @wufe/mapper

*

Configuration

Each map ruleset requires a mapping signature, to be able to identify object types at runtime.

Create a mapper and instantiate your first map ruleset
Syntax:
mapper.createMap(signature: MapSignature, destination: { new(): D })

``typescript
const mapper = new Mapper();
const sourceDestinationSignature: MapSignature = {
source: Symbol('SourceClass'),
destination: Symbol('DestinationClass')
};
mapper.createMap(sourceDestinationSignature, DestinationClass);
`

To apply the mapping
Syntax:
mapper.map(signature: MapSignature, source: S)

`typescript
const sourceObject = new SourceClass();
sourceObject.a = 'a';
const destinationObject = mapper.map(sourceDestinationSignature, sourceObject);
// destinationObject.a is now 'a'
`

*

$3

It is possible to create a map rule set without a signature, using the mapTo decorator.

Syntax:
`typescript
@mapTo(Destination)
class Source {}
`

Example:
`typescript
import { Mapper } from '@wufe/mapper';

class Destination {
class Destination {
destGreeting: string;
constructor() {
this.destGreeting = 'destination';
}
}

@mapTo(Destination)
class Source {
sourceGreeting: string;
constructor() {
this.sourceGreeting = 'source';
}
}

const mapper = new Mapper();
mapper.createMap(Source)
.forMember("destGreeting", opt => opt.mapFrom(src => src.sourceGreeting));

const sourceEntity = new Source();

const destinationEntity = mapper.map(sourceEntity);
``

*

$3

More examples are available in the tests folder.

*

Documentation

Check the documentation in the wiki.