@patryk-w-bl/ts-migrate-server/README.md

A package that contains the main migration runner and spawns a TSServer process

# ts-migrate-server

`ts-migrate-server` is a package that contains the main migration runner.
`ts-migrate-server` is designed around Airbnb projects. Use at your own risk.

# Install

Install _ts-migrate-server_ using [npm](https://www.npmjs.com):

`npm install --save-dev ts-migrate-server`

Or [yarn](https://yarnpkg.com):

`yarn add --dev ts-migrate-server`

# Usage

```typescript
import path from "path";
import { migrate, MigrateConfig } from "ts-migrate-server";

// get input files folder
const inputDir = path.resolve(__dirname, "input");

// create new migration config. You can add your plugins there
const config = new MigrateConfig();

// run migration
const exitCode = await migrate({ rootDir: inputDir, config });

process.exit(exitCode);
```

# FAQ

> How can I use _ts-migrate-server_?

You can take a look at [basic usage example](https://github.com/patryk-w-bl/ts-migrate/blob/master/packages/ts-migrate-example/src/index.ts#L2).
Another resource would be [source code](https://github.com/patryk-w-bl/ts-migrate/blob/master/packages/ts-migrate/cli.ts) of the _ts-migrate_ cli.

> Why not just use codemods?

You actually can use [codemods](https://github.com/patryk-w-bl/ts-migrate/blob/master/packages/ts-migrate-plugins/src/plugins/declare-missing-class-properties.ts) in your plugins!
_ts-migrate-server_ provides a more standardized API around TypeScript compiler usage and allows us to use the benefits of the TypeScript APIs without complicated setup.

> I have an issue with a specific plugin, what should I do?

Please file an [issue here](https://github.com/patryk-w-bl/ts-migrate/issues/new).

# Contributing

See the [Contributors Guide](https://github.com/patryk-w-bl/ts-migrate/blob/master/CONTRIBUTING.md).