# newsource-config-module

> Newsource Utility Wrapper for Configuration

Latest version **1.1.1** (published 2026-06-04) · ISC license · 0 weekly downloads

## Install

```sh
npm install newsource-config-module
pnpm add newsource-config-module
yarn add newsource-config-module
bun add newsource-config-module
```

## Health

**Score 45/100 (D)** — status: active.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 1.1.1 |
| Published | 2026-06-04 |
| First published | 2019-04-30 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 12.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | mss-npm-user |
| Maintainers | mss-npm-user |
| Keywords | Turner, Newsource, Config |

## Links

- npm: https://www.npmjs.com/package/newsource-config-module
- npm.io page: https://npm.io/package/newsource-config-module

## Dependencies (1)

- [@aws-sdk/client-ssm](https://npm.io/package/@aws-sdk/client-ssm.md) ^3.637.0

## Alternatives

- [jsforce](https://npm.io/package/jsforce.md) — 851.2K weekly downloads
- [react-native-qrcode-svg](https://npm.io/package/react-native-qrcode-svg.md) — 693.5K weekly downloads
- [@salesforce/plugin-data](https://npm.io/package/@salesforce/plugin-data.md) — 394.9K weekly downloads
- [@backstage/plugin-search-common](https://npm.io/package/@backstage/plugin-search-common.md) — 308.5K weekly downloads
- [@chain-registry/types](https://npm.io/package/@chain-registry/types.md) — 38.4K weekly downloads

## Recent versions

- 1.1.1 (latest) — 2026-06-04
- 1.1.0 — 2024-08-30
- 1.0.5 — 2021-03-23
- 1.0.4 — 2019-05-06
- 1.0.2 — 2019-05-01
- 1.0.1 — 2019-05-01
- 1.0.0 — 2019-04-30

## README

# Config Module #

This repository is a Node.js Module to encapsulate logic related to handling loading of configuration from external sources

## Setup ##

##### Run one of the following commands in the root directory of your project
```
#!shell

npm install newsource-config-module --save
```

## Usage ##
##### Usage of the module as follows
```
const configParser = require('newsource-config-module');
const config = {
   mySql: {
      host: "${env:MYSQL_HOST}",
      password: "${ssm:/path/to/mysql/password"}
   }
};
const parsedConfig = await configParser.parseConfig(config);
console.log(`MySQL host: ${parsedConfig.mySql.host} and password: ${parsedConfig.mySql.password}`);
```

## Parameter Store Usage Tracking ##
There is custom logic that looks for the following 3 environment variables. If these variables are found, this module will add 3 tags to the retrieved parameters in parameter store. It will populate `last-accessed-date` with a timestamp in UTC, `environment` with the contents of `NODE_ENV` and will populate `last-accessed-by` with the contents of the `APP_NAME` environment variable. (Note: because tag keys must be unique, these values will be overwritten if there are multiple apps retrieving the same parameter). This functionality is meant to be used in downstream environments only. 
```
NODE_ENV=dev
APP_NAME=my-custom-app
TAG_PARAM_STORE_USAGE=true
```

## Versioning ##

##### If you want to sync your Git commit with the version of your module

```
#!shell

git tag [major].[minor].[patch]
git push origin master --tags
```
## NPM version ##
Use npm publish to publish new version of the module (after modifying package.json and pushing a tag to git)

---
_Source: https://npm.io/package/newsource-config-module · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
