Motivation

We all know the pain that comes with using environment variables in your application. Since each variable is a string you have to cast the content of it to actually use it.

With type-cfg there is just one declartion for your entire application: one config to rule them all.

Installation

1. Install the node package: npm install type-cfg --save OR yarn add type-cfg
2. You also need to install reflect-metadata shim: npm install reflect-metadata --save OR yarn add reflect-metadata
3. Add reflect-metadata to your app-entry file: import 'reflect-metadata';
4. 🔥 Enjoy!

Documentation

Basic Usage

import TypeConfig, { Definition, Property } from 'type-cfg';

@Definition()
class Config extends TypeConfig {
  @Property({ source: 'NODE_ENV' })
  environment: string;
}

const config = new Config();

if (config.environment === 'development') {
  // ...
}

Examples

• Basic Usage
• Arrays
• Nested
• TypeDI

Decorators

@Definition

Scope: Class Decorator

Configuration

Usage

@Definition();

@Property

Scope: Property Decorator

Configuration

| Property | Required | Default | Description | | -------------- | -------- | ------- | ----------------------------------------------------------------------------------------------- | | source | ❌ | - | The environment variable / object key as a string of the value you want to acquire | | delimiter | ❌ | , | The delimiter used to split the value into an array | | required | ❌ | true | Marks the property as required | | defaultValue | ❌ | - | The default value. Note that the defaultValue will be applied even if the value is required |

Usage

@Property();
@Property(options: PropertyOptions);
@Property(typeFunction: TypeFunction);
@Property(typeFunction: TypeFunction, options: PropertyOptions);

Accumulate

Once your configuration is decorated you can accumulate it...

...by using a function call

import { accumulate } from 'type-cfg';

const config = new MyConfig();
accumulate(config);

// ...

...by using the abstract class

import TypeConfig, { Definition, Property } from 'type-cfg';

class MyConfig extends TypeConfig {
  // ...
}

const config = new MyConfig();

// ...

Thank you

A huge thanks goes to the creators of TypeGraphQL and TypeORM. They gave me the inspiration to not only manage GraphQL schemas and Database relations but also configurations.