Rockets NestJS TypeOrm Extended

Extremely powerful extension of the NestJS TypeOrm module that allows your dynamic modules to accept drop-in replacements of custom entities and repositories at registration time.

Project

Overview

The TypeOrm Ext module provides a powerful wrapper around the @nestjs/typeorm module.

While still using the identical configuration options of the TypeOrm module, you can increase the extensibility of your custom module by designing it to accept custom entity and repository overrides.

This pattern allows you to publish modules that are loosely coupled to their own entity and repository definitions. This enables implementations of your module to define their own concrete data storage.

Installation

yarn add @concepta/nestjs-typeorm-ext

Module Design

Designing your module to use this extension is fairly straight forward, but a bit too verbose for this readme.

To see how this was implemented in our UserModule please refer to that module's user.module.ts

Usage

app.module.ts

1// ...
2import { TypeOrmExtModule } from '@concepta/nestjs-typeorm-ext';
3import { UserModule } from '@concepta/nestjs-user';
4import { CustomUserRepository } from 'path/to/custom-user.repository';
5import { CustomUser } from 'path/to/custom-user.entity';
6
7@Module({
8  imports: [
9    TypeOrmExtModule.forRoot({
10      type: 'postgres',
11      url: 'postgres://user:pass@localhost:5432/postgres',
12      entities: [CustomUser],
13    }),
14    UserModule.forRoot({
15      entities: {
16        user: { entity: CustomUser, repository: CustomUserRepository },
17      },
18    }),
19  ],
20})
21export class AppModule {}

Configuration

Data Source Options

The module options are identical the the NestJS TypeOrm module.