nest-utils

Description

Contains Nobrainer Labs commonly used code like postgres naming strategy, nest decorators, and pipes.

Requirements

Make sure to have the following installed

• NodeJS / NPM for application runtime
• NestJS for application framework

Installation

To use the nest-utils node module:

$ npm login #make sure you request access to @nobrainerlabs
$ npm install --save @nobrainerlabs/nest-utils

Postgres Naming Strategy

TypeORM by default retains camelCase naming convention for table and column names. Also, constraints, relations, primary keys, and foreign key names generated by TypeORM do not follow industry best practices. The PostgresNamingStrategy overrides TypeORM's default naming strategy.

To use, modify the NestJS module imports to include the namingStrategy property:

TypeOrmModule.forRoot({
  ...
  namingStrategy: new PostgresNamingStrategy()
});

Config Module based on ConvictJS

See README here for more details on setup and configuration.

NestJS Decorators

TODO:

• Document request-property.decorator
• Document replace-relation-type.decorator

NestJS Pipes

TODO:

• Document parse-entity.pipe
• Document required.pipe

Contributing

To contribute to the nest-utils project please make sure to have the following configured in your development environment. Submit pull request to master after making sure all unit tests run successful.

• tslint for TypeScript linting (tslint in VSCode to automate linting)
• jest for unit testing

Development environment setup

$ npm install

If you would like to develop/debug nest-utils in your source project you can npm link to symlink cross-dependency:

# Run npm link on this project
$ npm link

# Run npm link on your project
$ npm link @nobrainerlabs/nest-utils

Test

All code changes should have supported unit tests.

# unit tests
$ npm run test

# test coverage
$ npm run test:cov