A configuration contract for Node + AWS projects.
The contract that this package implements covers the following:
- Error handling and assertion of configuration values. Empty or missing values stop execution.
- Ease of access to environment variables
- Ease of access to AWS SSM Parameters
- Ease of access to AWS Secrets Manager secrets
- No need to use or access
process.env - Specify default values for configuration
- Provide canonical environment names, centalize environment parsing
For TypeScript users, known configuration values are provided in intellisense based on the keys of configuration options passed to init.
This package requires an Active LTS Node version (v18+).
Using pnpm:
pnpm add @dot/configimport { env, init } from '@dot/config';
const defaultConfig = { ... };
const secretConfig = {
BATCAVE_CODE: `/${env}/batcave/code`
};
const ssmConfig = { ... };
const { get } = init({ defaultConfig, pkg, secretConfig, ssmConfig });
const value = await get('BATCAVE_CODE');Type: Enum
An enum representing common Node, deployment, or run environments.
enum DotEnv {
DEV = 'dev',
PROD = 'prod',
STAGE = 'stage',
TEST = 'test'
}Type: String
Represents the current env value, corresponding to DotEnv.
Type: String
Represents the current env value in a prefix useful for deployment resource identifiers and other identifiers or prefixes. e.g. prod-
Type: Function
Returns: { get, put }
Initializes a configuration getter and putter.
Type: Object
An object whereby keys identify configuration values.
Type: Object
An object whereby keys match AWS SecretsManager names.
Type: Object
An object whereby keys match AWS SSM Parameter Store paths.
Type: Function
Parameters: (key: String)
Returns: Promise<String | Number>
Get a value for the specified key. The key may represent a key present on:
process.env- The default configuration object
- The secrets configuration object
- The SSM configuration object
If the key does not exist, or the value returned from any of the possible sources is undefined, a RangeError is thrown.
const name = await get('BATMAN');Type: Function
Parameters: (key: String, value: any)
Returns: Promise<AWS Response>
Saves a value to the specified key, which corresponds to an AWS SSM Parameter Path. This function is limited to AWS SSM Parameter Store.
await put('DB_NAME', 'batman');