1.1.1 • Published 9 months ago

@learningalbum/env-validation v1.1.1

Weekly downloads
-
License
ISC
Repository
github
Last release
9 months ago

ENV validation library

This library is designed to support validating environment variables for a nodejs application of any kind.

How to use

In a file (e.g. config.js)

require('dotenv').config();

const {validate, validations, preProcessors} = require('@learningalbum/env-validation');

const {castBool} = preProcessors;
const {mustBeOneOf, requiredIfPresent, requiredIfTrue} = validations;

const varsConfig = [
  // Array of variable configs (see below)
  {
    name: 'MY_VAR',
    require: true,
  }
]

// Get the validated vars into an object like {VAR1, VAR2, VAR3, etc} 
module.exports = validate(varsConfig);

Then in your application code, wherever you need config from your env, you do stuff like:

const { MY_VAR } = require('config.js');
// Do something with MY_VAR

or, if using ESM:

import envs from './config.js';
const { MY_VAR } = envs;

If MY_VAR doesn't validate in the way you've configured in config.js, an error will be thrown with an error message describing why.

Variable configs

Declare each variable you want to validate. For full details on the interface, please see src/types.ts.

keytyperequired?description
namestringyesthe name of the variable to pick up from process.env
defaultanynoa default value to use
preProcess(val: any) => anynofunction to transform the value before any validation
validationsarray of (val: any, context?: EnvContext) => booleannofunction to validate the value
deprecatedbooleannowhether this var is marked as deprecated
messagestringnothe deprecation message to show if the deprecated var is present (only relevant when deprecated: true)
1.1.1

9 months ago

1.1.0

9 months ago

1.0.9

2 years ago

1.0.8

2 years ago

1.0.7

2 years ago