Banco de dados

Configuração TypeORM com PostgreSQL via DatabaseModule e DataSource factory.

A infraestrutura de banco usa TypeORM com PostgreSQL. A conexão é gerenciada por um DataSource singleton injetado via token customizado.

DatabaseModule

typescript

@Module({
  providers: [
    EnvService,
    {
      provide: DATA_SOURCE_PROVIDER_TOKEN,
      useFactory: dataSourceFactory,
      inject: [EnvService],
    },
  ],
  exports: [EnvService, DATA_SOURCE_PROVIDER_TOKEN],
})
export class DatabaseModule {}

Factory do DataSource

typescript

export const DATA_SOURCE_PROVIDER_TOKEN = 'DATA_SOURCE';

export async function dataSourceFactory(env: EnvService) {
  const dataSource = new DataSource({
    type: 'postgres',
    url: env.get('DATABASE_URL'),
    entities: [Person, PersonAddress, PersonContact],
    invalidWhereValuesBehavior: {
      undefined: 'ignore',
    },
  });

  await dataSource.initialize();

  return dataSource;
}

Token de injeção

Repositórios recebem o DataSource via token, não pela classe diretamente:

typescript

constructor(@Inject(DATA_SOURCE_PROVIDER_TOKEN) dataSource: DataSource) {
  super(dataSource, Person);
}

Variável de ambiente

A URL de conexão vem de DATABASE_URL, validada no schema Zod (formato do .env.example):

env

DATABASE_URL=postgresql://postgres:root@localhost:5432/koala_nest

Adicionar novas entidades

Crie a entidade em src/domain/entities/.
Inclua-a no array entities do dataSourceFactory.
Gere e aplique a migration.

O migration-datasource.ts descobre entidades automaticamente via glob — não é necessário registrá-las manualmente lá.

InfraModule

O InfraModule agrega repositórios e exporta o RepositoryModule:

typescript

@Module({
  imports: [RepositoryModule],
  exports: [RepositoryModule],
})
export class InfraModule {}