Com a versão 0.3.0 algumas coisas deixaram de funcionar, outras mudaram seu funcionamento. Nesse guia rápido, vamos passar por alguns pontos essenciais que necessitam de atualização no TypeORM na aplicação Rentx, desenvolvida no Ignite Node.js.

<aside> ⚠️ Antes de tudo, é extremamente importante que leiam com muita atenção o changelog da versão 0.3.0, pois neste guia não será explicada todas as alterações da versão, apenas as necessárias para refatorar o Rentx.

Link: Release 0.3.0 · typeorm/typeorm (github.com)

</aside>

Pontos de atenção

Conexão e configuração

O arquivo ormconfig. foi descontinuado. A nova forma de conexão e configuração é por meio da classe DataSource.

Essa classe pode receber as entities e migrations, assim como na configuração antiga, por meio do array de string (caminho para serem carregados), mas essa funcionalidade já está como depreciada e será removida nas versões futuras, por isso o ideal é informar diretamente cada classe no array.

Exemplo:

const dataSource = new DataSource({
  type: "postgres",
  port: 5432,
  username: "docker",
  password: "ignite",
  database: "rentx",
  entities: [
    Category,
    // ...
  ],
  migrations: [
    CreateCategories1616082124654,
    // ...
  ],
});

Para iniciar a conexão é preciso executar o método initialize da instância da classe.

Para encerrar a conexão não é mais o método close, e sim o destroy.

CLI

Todos os comandos da cli também não suportam mais o arquivo ormconfig., agora é preciso informar o caminho para um arquivo que exporte por padrão uma instância da classe DataSource.

Exemplo:

yarn typeorm -d ./src/shared/infra/typeorm/index.ts migration:run

Repositórios

Para acessar os repositórios do TypeORM, antes era importado o método getRepository, essa forma está depreciada. Para recuperar os repositórios é preciso importar o dataSource e utilizar o método getRepository por ele.

Exemplo:

import dataSource from "@shared/infra/typeorm";
import { Category } from "../entities/Category";

const categoriesRepository = dataSource.getRepository(Category);