feat(core): add autoMap mapping configuration (#538)

Avoid using the @AutoMap decorator by replacing it with calls to
autoMap inside the profile.

packages/core/src/index.ts

@@ -20,6 +20,7 @@ export * from './lib/mapping-configurations/before-map';
 export * from './lib/mapping-configurations/after-map';
 export * from './lib/mapping-configurations/extend';
 export * from './lib/mapping-configurations/naming-conventions';
+export * from './lib/mapping-configurations/auto-map';
 
 export * from './lib/member-map-functions/map-from';
 export * from './lib/member-map-functions/map-with';

packages/core/src/lib/mapping-configurations/auto-map.ts

@@ -0,0 +1,16 @@
+import type { MappingConfiguration } from '../types';
+import { mapFrom } from '../member-map-functions/map-from';
+
+import { forMember } from './for-member';
+
+export function autoMap<
+    TSource extends { [key in TKey]: TValue },
+    TDestination extends { [key in TKey]: TValue },
+    TKey extends keyof TSource & keyof TDestination,
+    TValue extends TSource[TKey] & TDestination[TKey]
+>(prop: TKey): MappingConfiguration<TSource, TDestination> {
+    return forMember(
+        (dest) => dest[prop] as TValue,
+        mapFrom((src) => src[prop])
+    );
+}

packages/integration-test/src/classes/dtos/decoratorless-user.dto.ts

@@ -0,0 +1,5 @@
+export class DecoratorlessUserDto {
+    firstName!: string;
+    lastName!: string;
+    fullName!: string;
+}

packages/integration-test/src/classes/map-without-decorators.spec.ts

@@ -0,0 +1,43 @@
+import { classes } from '@automapper/classes';
+import { addProfile, createMapper } from '@automapper/core';
+
+import { DecoratorlessUserDto } from './dtos/decoratorless-user.dto';
+import { DecoratorlessUser } from './models/decoratorless-user';
+import { decoratorlessUserProfileFactory } from './profiles/decoratorless-user.profile';
+
+describe('Map Without Decorators', () => {
+    const mapper = createMapper({ strategyInitializer: classes() });
+
+    beforeAll(() => {
+        addProfile(mapper, decoratorlessUserProfileFactory());
+    });
+
+    it('should map model to DTO', async () => {
+        const dto = await mapper.mapAsync(
+            new DecoratorlessUser('Gabriel', 'Kim'),
+            DecoratorlessUser,
+            DecoratorlessUserDto
+        );
+
+        expect(dto.firstName).toEqual('Gabriel');
+        expect(dto.lastName).toEqual('Kim');
+        expect(dto.fullName).toEqual('Gabriel Kim');
+    });
+
+    it('should map DTO to model', async () => {
+        const dto = new DecoratorlessUserDto();
+        dto.firstName = 'Gabriel';
+        dto.lastName = 'Kim';
+        dto.fullName = 'Gabriel Kim';
+
+        const model = await mapper.mapAsync(
+            dto,
+            DecoratorlessUserDto,
+            DecoratorlessUser
+        );
+
+        expect(model.firstName).toEqual('Gabriel');
+        expect(model.lastName).toEqual('Kim');
+        expect(model).not.toHaveProperty('fullName');
+    });
+});

packages/integration-test/src/classes/models/decoratorless-user.ts

@@ -0,0 +1,9 @@
+export class DecoratorlessUser {
+    firstName!: string;
+    lastName!: string;
+
+    constructor(firstName: string, lastName: string) {
+        this.firstName = firstName;
+        this.lastName = lastName;
+    }
+}

packages/integration-test/src/classes/profiles/decoratorless-user.profile.ts

@@ -0,0 +1,33 @@
+import {
+    autoMap,
+    createMap,
+    forMember,
+    mapFrom,
+    MappingProfile,
+} from '@automapper/core';
+import { DecoratorlessUserDto } from '../dtos/decoratorless-user.dto';
+import { DecoratorlessUser } from '../models/decoratorless-user';
+
+export function decoratorlessUserProfileFactory(): MappingProfile {
+    return (mapper) => {
+        createMap(
+            mapper,
+            DecoratorlessUser,
+            DecoratorlessUserDto,
+            autoMap('firstName'),
+            autoMap('lastName'),
+            forMember(
+                (d) => d.fullName,
+                mapFrom((s) => s.firstName + ' ' + s.lastName)
+            )
+        );
+
+        createMap(
+            mapper,
+            DecoratorlessUserDto,
+            DecoratorlessUser,
+            autoMap('firstName'),
+            autoMap('lastName')
+        );
+    };
+}