Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@nartc/automapper

nartc3.1kMIT7.0.4TypeScript support: included

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

readme

AutoMapper

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

Travis (.com) npm bundle size (scoped) npm npm (scoped) NPM Coveralls github Snyk Vulnerabilities for GitHub Repo

Migrations to v6

  • 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)
);

Migrations from automapper-nartc

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(...));

Migrations to v3

  • 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;
}

Features

So far, the following is supported:

  • <input checked="" disabled="" type="checkbox"> Basic Mapping between two classes
  • <input checked="" disabled="" type="checkbox"> Basic Mapping for nested classes
  • <input checked="" disabled="" type="checkbox"> Mapping Inheritance - with caveats regarding typings.
  • <input checked="" disabled="" type="checkbox"> Array/List Mapping
  • <input checked="" disabled="" type="checkbox"> Flattening
  • <input checked="" disabled="" type="checkbox"> ReverseMap
  • <input checked="" disabled="" type="checkbox"> Value Converters
  • <input checked="" disabled="" type="checkbox"> Value Resolvers
  • <input checked="" disabled="" type="checkbox"> Async (Read more at Async Support)
  • <input checked="" disabled="" type="checkbox"> Before/After Callback
  • <input checked="" disabled="" type="checkbox"> 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.

  • Circular Dependencies

  • <input checked="" disabled="" type="checkbox"> Tree-shakable

Unsupported features:

  • <input disabled="" type="checkbox"> Type Converters
  • <input disabled="" type="checkbox"> Value Transformers

Circular Dependencies

Please check out the Circular Dependencies Documentations

Documentations

Check out the AutoMapper TypeScript Documentations

Demo

Codesandbox Demo

Contribution

Contribution of any kind is always welcomed.

MIT License