@corentind/aws-ssm-config NPM

aws-ssm-config

Fetch your configuration from AWS SSM Parameter store easily

This package comes from a refactoring problem that I had during a personal project. Basically, I stored by configuration on AWS SSM Parameter Store and wanted to retrieve it in a simple, type-safe and efficient way. So I made a simple package that I could reuse to make it easy and BOOM ! Here is aws-ssm-config !

Installation

npm install @corentind/aws-ssm-config

or if using Yarn :

yarn add @corentind/aws-ssm-config

Usage

Basic usage

import { SSMConfigClient } from '@corentind/aws-ssm-config';

// Create a client and provide the base path.
const client = new SSMConfigClient({
  basePath: '/myproject/api/prod'
});

// You can now retrieve parameters under this base path.
client.getByKey('mongo-url')
  .then(url => /* connect to MongoDB... */)
  .catch(error => console.error('Something went wrong : ', error));

On-fly decryption

import { SSMConfigClient } from '@corentind/aws-ssm-config';

const client = new SSMConfigClient({
  basePath: '/myproject/api/prod',
  withDecryption: true
});

client.getByKey('mongo-password')
  .then(password => /* SecureString is decrypted. */)
  .catch(error => console.error('Something went wrong : ', error));

XRay Tracing

import { SSMConfigClient } from '@corentind/aws-ssm-config';

// By specifying the `capture` option, all API calls will be captured by XRay.
const client = new SSMConfigClient({
  basePath: '/myproject/api/prod',
  capture: true
});

Overriding global options

import { SSMConfigClient } from '@corentind/aws-ssm-config';

const client = new SSMConfigClient({
  basePath: '/myproject/api/prod'
});

client.getByKey('common-prop', { basePath: '/myproject/common/prod' })
  .then(someProp => /* do something... */)
  .catch(error => console.error('Something went wrong : ', error));

Default configuration

import { SSMConfigClient } from '@corentind/aws-ssm-config';

// By providing a `config` object property, it will use the provided object instead of
// querying the SSM Parameter Store.
const client = new SSMConfigClient({
  basePath: '/myproject/api/prod',
  ...(process.env.NODE_ENV === 'local' && {
    config: {
      someServiceEndpoint: 'http://localhost:3030'    
    }
  })
});

client.getByKey('someServiceEndpoint')
  .then(serviceEndpoint => /* `http://localhost:3030`... */)
  .catch(error => console.error('Something went wrong : ', error));

Typescript support

import { SSMConfigClient } from '@corentind/aws-ssm-config';

// First, create a type for your configuration
interface MyConfig {
  someIntProperty: number;
}

// Then, create a client and provide the interface type parameter.
const client = new SSMConfigClient<MyConfig>({
  basePath: '/myproject/api/prod'
});

// You can now retrieve parameters in a type-safe fashion.
client.getByKey('someIntProperty')
  .then(anInt => /* anInt.toExponential() */)
  .catch(error => console.error('Something went wrong : ', error));

Development setup

The project was created and built with Yarn, so please use it too for development. Install dependencies :

yarn

Release History

0.2.0
- Added type-safe client
- Added default configuration support
- Removed capture parameter overrides
- Updated documentation
0.1.2
- Fixed .npmignore
- Updated NPM badges
0.1.1
- Added SSMClientConfig
- Allows to retrieve one parameter at a time by key
- Allows on-fly decryption
- Allows XRay tracing