@alwatr/env

A tiny and tree-shakable TypeScript library to get environment variables with type-safe and fallback value for development and production.

Installation

npm install @alwatr/env

Usage

import {getEnv} from '@alwatr/env';

const env = getEnv({
  name: 'MY_ENV_VAR',
  defaultValue: 'default-value',
  developmentValue: 'development-value',
});

console.log(env); // Output: 'development-value' in development mode, 'default-value' if MY_ENV_VAR is not set in production mode.

API

getEnv(option: GetEnvValueOption): string

Retrieves the value of an environment variable.

Parameters:

• option: An object with the following properties:
  • name: The name of the environment variable.
  • defaultValue: The default value to use if the environment variable is not set.
  • developmentValue: The value to use in a development environment.

Returns:

The value of the environment variable.

Throws:

An error if the environment variable is not set and no default value is provided.

Examples

Basic usage:

const dbUrl = getEnv({name: 'DATABASE_URL', defaultValue: 'mongodb://localhost:27017'});

Development value:

const apiUrl = getEnv({
  name: 'API_URL',
  defaultValue: 'https://api.example.com',
  developmentValue: 'http://localhost:3000',
});

Required environment variable:

const apiKey = getEnv({name: 'API_KEY'}); // Throws an error if API_KEY is not set

Sponsors

The following companies, organizations, and individuals support Nanolib ongoing maintenance and development. Become a Sponsor to get your logo on our README and website.

Contributing

Contributions are welcome! Please read our contribution guidelines before submitting a pull request.