configchecker

Config Checker

A very simple and effective way to check config, before it's used in runtime with nice fluent API. Here is the full documentation.

Install

Install from NPM

npm i configchecker

Story

When you use some ENV value do you really know what it contains or if it is really defined?

export const { TESTING_MAIL } = process.env;

This will be OK until your server tries to send some email. Maybe it drops the whole server or just don't do nothing and you will be figuring out why the hell server is working but it doesn't send any emails.

I have this problem many many times.

And because I am a TypeScript lover it is fully using all advantages of static typing.

Usage

I load the config from some environment Object:

import { ConfigChecker } from 'configchecker';

const config = ConfigChecker.from(process.env);

And then I can read variabiles from it:

config.get('TESTING_MAIL').value;

I can enforce them:

config.get('TESTING_MAIL').required().value;

I can convert them to certain types:

config.get('...').number().value;
config.get('...').boolean().value;
config.get('...').json().value;
config.get('...').list().value;
config.get('...').date().value;
config.get('...').url().value;

Full sample 1

import { ConfigChecker } from 'configchecker';
const config = ConfigChecker.from(process.env);

export const PORT = config.get('PORT').number().required().value;
export const TESTING_MAIL = config.get('TESTING_MAIL').value;

Full sample 2

This sample is working same like sample 1 but unfortunately it is not using full TypeScript potential.

import { ConfigChecker } from 'configchecker';
const config = ConfigChecker.from(process.env);

export default {
    ...config.get('PORT').number().required().object,
    ...config.get('TESTING_MAIL').object
}

Contributing

I am opened to your pull requests, feedback, suggestions and donations :) . Contact to me is on my personal page

Authors

• Pavol Hejný
• David Pohan

Thanks

To boilerplate was used my-awesome-greeter.