# @automapper/core

> AutoMapper TypeScript Core

Latest version **9.0.2** (published 2026-07-16) · MIT license · 0 weekly downloads

## Install

```sh
npm install @automapper/core
pnpm add @automapper/core
yarn add @automapper/core
bun add @automapper/core
```

## Health

**Score 60/100 (C)** — status: active.

Positive: has types; esm support; no vulnerabilities; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 9.0.2 |
| Published | 2026-07-16 |
| First published | 2021-01-04 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM |
| Node | >=20.0.0 |
| Dependencies | 0 |
| Unpacked size | 106.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1007 |
| Author | Chau Tran |
| Maintainers | nartc |
| Keywords | typescript, automapper, mapper, nx |

## Links

- npm: https://www.npmjs.com/package/@automapper/core
- Repository: https://github.com/nartc/mapper.git#main
- Homepage: https://github.com/nartc/mapper/tree/main#readme
- Issues: https://github.com/nartc/mapper/issues
- npm.io page: https://npm.io/package/@automapper/core

## Alternatives

- [@openai/codex-sdk](https://npm.io/package/@openai/codex-sdk.md) — 731.4K weekly downloads
- [babel-plugin-transform-react-jsx](https://npm.io/package/babel-plugin-transform-react-jsx.md) — 565.0K weekly downloads
- [babel-helper-remove-or-void](https://npm.io/package/babel-helper-remove-or-void.md) — 508.5K weekly downloads
- [@pnpm/store-controller-types](https://npm.io/package/@pnpm/store-controller-types.md) — 186.9K weekly downloads
- [react-native-signature-canvas](https://npm.io/package/react-native-signature-canvas.md) — 155.6K weekly downloads

## Recent versions

- 9.0.2 (latest) — 2026-07-16
- 9.0.0-alpha.1 (beta) — 2026-06-24
- 9.0.1 — 2026-07-15
- 9.0.0 — 2026-07-15
- 9.0.0-alpha.0 — 2026-06-23
- 8.8.1 — 2024-01-23
- 8.8.0 — 2024-01-22
- 8.7.7 — 2022-10-25
- 8.7.6 — 2022-08-31
- 8.7.5 — 2022-08-03
- 8.7.4 — 2022-08-02
- 8.7.3 — 2022-08-02
- 8.7.2 — 2022-07-31
- 8.7.1 — 2022-07-29
- 8.7.0 — 2022-07-27
- … 130 more at https://npm.io/package/@automapper/core/versions

## README

# @automapper/core

This is the core package that will handle mapping configurations and mapping operations.

## Installation

```sh
npm i @automapper/core
```

or with `yarn`

```sh
yarn add @automapper/core
```

## Usage

`@automapper/core` exposes `createMapper()` method to create a `Mapper` object with a accompany `MappingStrategy` (read more
about [Strategies](#Strategies))

`createMapper` accepts a `CreateMapperOptions` object with the following shape:

```ts
export interface CreateMapperOptions {
    strategyInitializer: MappingStrategyInitializer<MetadataIdentifier>;
    errorHandler?: ErrorHandler;
    namingConventions?: NamingConventionInput;
}
```

Read more about usage on [documentation site](https://automapperts.netlify.app/docs/api/create-mapper)

## Strategies

A given Mapper is accompanied by a Strategy by providing `strategyInitializer` when using `createMapper()`.

A Strategy will be responsible for:

-   Discover metadata (eg: `classes` uses `@AutoMap()` decorator to discover the metadata of the properties on the Classes)
-   Retrieve metadata: how the metadata should be retrieved from the discovery phase (eg: `classes` discovers and stores the metadata to `Reflect`, retrieve metadata simply gets them from `Reflect`)
-   Apply metadata: how the metadata is applied to the Model

`@automapper` provides the following official strategies:

-   `@automapper/classes`: Work with TS/ES6 classes.
-   `@automapper/pojos`: Work with Interfaces/Types along with POJOs. In projects that do not make use of Class, `pojos`
    can be used instead.
-   `@automapper/mikro`: Work together with TS/ES6 classes along with [MikroORM](https://github.com/mikro-orm/mikro-orm)
-   `@automapper/sequelize`: Work together with TS/ES6 classes along with [Sequelize](https://github.com/sequelize/sequelize)

---
_Source: https://npm.io/package/@automapper/core · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._