@beesley/ts-env

@beesley/ts-env / Exports

An environment variable reader for TypeScript. Simple and minimal. ✨

This is basically the package created by @lpgera, but since that package doesn't play well at all with typescript when you're using es modules I've forked it and rebuilt is as a universal package to work with either es modules or common js.

Install

This package requires typescript to be installed.

# with npm
npm install @beesley/ts-env

# or with Yarn
yarn add @beesley/ts-env

Example

Reading different types of environment variables without ts-env:

if (!process.env.PORT) {
  throw new Error('process.env.PORT is missing')
}
if (!process.env.DATABASE) {
  throw new Error('process.env.DATABASE is missing')
}

const port: number = parseInt(process.env.PORT)
const database: string = process.env.DATABASE
const debug: boolean | undefined = process.env.DEBUG === 'true'

Doing the same with ts-env:

import tsEnv from '@beesley/ts-env'

const port: number = tsEnv.numberOrThrow('PORT')
const database: string = tsEnv.stringOrThrow('DATABASE')
const debug: boolean | undefined = tsEnv.boolean('DEBUG')

API

.string(key: string): string | undefined

Reads a string value from process.env[key].

.stringOrThrow(key: string): string

Reads a string value from process.env[key]. Throws an error if it's undefined.

.boolean(key: string): boolean | undefined

Reads a boolean value from process.env[key]. "0" and "false" are considered false, "1" and "true" are considered true. Everything else will be read as undefined.

.booleanOrThrow(key: string): boolean

Reads a boolean value from process.env[key]. "0" and "false" are considered false, "1" and "true" are considered true. Everything else will result in an error thrown.

.number(key: string): number | undefined

Reads a number value from process.env[key]. If a number cannot be parsed, it will return undefined.

.numberOrThrow(key: string): number

Reads a number value from process.env[key]. If a number cannot be parsed, an error will be thrown.

.stringArray(key: string, separator: string = ','): string[] | undefined

Reads a string array from process.env[key].

.stringArrayOrThrow(key: string, separator: string = ','): string[]

Reads a string array from process.env[key]. Throws an error if it's undefined.

.numberArray(key: string, separator: string = ','): number[] | undefined

Reads a number array from process.env[key]. If any item cannot be parsed, it will return undefined.

.numberArrayOrThrow(key: string, separator: string = ','): number[]

Reads a number array from process.env[key]. If any item cannot be parsed, an error will be thrown.

Changelog

1.0.1 (2023-10-06)

Bug Fixes

• remove console.error (8480e54)

Features

• refactor to use node16 es modules (a877801)