@spacetab-io/configuration-js

Javascript microservice configuration library

Production-ready configuration for microservices. Written in TypeScript. Library works with nodejs apps and with browsers*.

Library created for follow up corporate standards of application configuration.

Installation

npm install --save @microparts/configuration-js
// or
yarn add @microparts/configuration-js

Usage

By default, path to configuration directory and application stage loading from /app/configuration with local stage.

Simple

import { Configuration } from '@microparts/configuration-js';

const conf = new Configuration();
conf.load();

console.log(conf.all()); // get all config
console.log(conf.get('foo.bar')); // get nested key use dot notation

If u would like override default values, you can pass 2 arguments to class constructor or set up use setters.

import { Configuration } from '@microparts/configuration-js';

const conf = new Configuration('./configuration', 'test');
// or
// conf.path = './configs';
// conf.stage = 'local';
conf.load();

conf.get('foo'); // full example on the top

If the operating system has an env variables CONFIG_PATH and STAGE, then values for the package will be taken from there.

export CONFIG_PATH=/configuration
export STAGE=prod

import { Configuration } from '@microparts/configuration-js';

const conf = new Configuration('./configuration', 'test');
conf.load(); // loaded files from /configuration for prod stage.

conf.get('foo'); // full example on the top

If u want to see logs and see how load process working, pass you logger to property:

Pass it like this:

import { Configuration, StdoutConsoleLogger } from '@microparts/configuration-js';

const conf = new Configuration();
conf.logger = new StdoutConsoleLogger();
conf.load();

conf.get('foo'); // full example on the top

Or if you would like use external logger, like Winston, you can integrate it with LoggerInterface. Just a write the adapter like as WinstonConsoleLogger.

For now, by default library support one Winston transport called Console. Okay, let's go use adapter for him...

First, install logger:

npm install --save winston
// or yarn add winston

Second, pass you logger to property like this:

import { Configuration, WinstonConsoleLogger, StdoutConsoleLogger } from '@microparts/configuration-js';

const conf = new Configuration();
conf.logger = new WinstonConsoleLogger(winston.createLogger({
  transports: [new winston.transports.Console()]
}));

conf.load();

conf.get('foo'); // get value of `foo`

How to usage library with SPA apps?

Note:
https://github.com/microparts/static-server-php is required for usage on the server/cloud.

For most cases, this Dockerfile can help your application build's in the cloud.

It simple. Step by step:

Create an vue app for example

vue create vue-app

Install this package

npm install --save @microparts/configuration-js

Put config files like this
Change vue.config.js to build final config to global variables:

const { Configuration, StdoutConsoleLogger } = require('@microparts/configuration-js');

module.exports = {
  lintOnSave: false,
  chainWebpack: config => {
    config.plugin('html').tap(options => {
      const conf = new Configuration('./configuration');
      conf.logger = new StdoutConsoleLogger(); // new StdoutConsoleLogger(true); // for debug
      conf.load();

      options[0].__config = conf.asEscapedJson();
      options[0].__stage = conf.stage;

      return options;
    });
  }
};

Add following code to index.html to top of <head> html tag (before all scripts):

<head>
  <% if (htmlWebpackPlugin.options.__stage === 'local') { %>
    <script>
      window.__config = JSON.parse("<%= htmlWebpackPlugin.options.__config %>");
      window.__stage = '<%= htmlWebpackPlugin.options.__stage %>';
      window.__vcs = '';
    </script>
  <% } %>
<!-- ... meta tags and other code -->

Add globals to .eslintrc:

"globals": {
  "__config": "readonly",
  "__stage": "readonly",
  "__vcs": "readonly"
 },

Run application.

npm run serve

Full example available at here.

License

The MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.