An object-to-object mapper by convention for TypeScript.

• initialize() has been deprecated in v6. Please use createMap(), addProfile(), and/or withGlobalSettings() directly
• Mapping operations have been rewritten as individual functions to support tree-shaking, please migrate your mapping configurations to use those

// before
Mapper.createMap(Source, Destination)
    .forMember(d => d.destMember, opts => opts.mapFrom(s => s.sourceMember);

// after
Mapper.createMap(Source, Destination)
    .forMember(d => d.destMember, mapFrom(s => s.sourceMember))

• Pre-Condition: preCondition() is also a separate function. Use in v6 as follow

// before
Mapper.createMap(Source, Destination).forMember(
  d => d.destMember,
  opts => opts.preCondition(predicate).mapFrom(s => s.sourceMember)
);

// after
Mapper.createMap(Source, Destination).forMember(
  d => d.destMember,
  preCondition(predicate),
  mapFrom(s => s.sourceMember)
);

The only migration step you need is to modify forMember() method.

In automapper-nartc, forMember() takes in a property string as the first argument. Now, forMember() in @nartc/automapper takes in a selector instead. This wil allow reverseMap() to work better.

// Before
Mapper.createMap(User, UserVm)
  .forMember('fullName', opts => opts.mapFrom(...));

// Now
Mapper.createMap(User, UserVm)
  .forMember(dest => dest.fullName, opts => opts.mapFrom(...));

• Change @Expose() and @ExposedType() to @AutoMap()

// Before
class User {
  @Expose()
  firstName: string;
  @ExposedType(() => Profile)
  profile: Profile;
}

// v3
class User {
  @AutoMap()
  firstName: string;
  @AutoMap(() => Profile)
  profile: Profile;
}

So far, the following is supported:

• Basic Mapping between two classes
• Basic Mapping for nested classes
• Mapping Inheritance - with caveats regarding typings.
• Array/List Mapping
• Flattening
• ReverseMap
• Value Converters
• Value Resolvers
• Async
• Before/After Callback
• Naming Conventions
• Null Substitution - @lqmanh pointed out the difference in fromValue() and nullSubstitution() use-case, and that difference is totally valid. Hence, nullSubstitution is now supported.

• Type Converters - Help needed
• Value Transformers

Check out the AutoMapper TypeScript Documentations

Codesandbox Demo

Contribution of any kind is always welcomed.