midgard-core

Frontend core module written in pure JavaScript providing common capabilities. It is published as an npm package and used as a dependency in the framework specific wrappers (midgard-angular, midgard-react).

The purpose of this project is to provide a common core for all Midgard implementations. All capabilities developed in this project should be generic enough that they would not force any of the framework specific implementations on top of it to adopt patterns which are not natural for those respective frameworks.

Currently, midgard-core implements 4 major features: an HTTP Client, a Redux Store, an oAuth Client, and a Logging Library

HTTP Client

The HTTP Client exposes just one method which allows developers to make HTTP requests of all kinds. This method - request - in turn wraps the axios library.

Redux Store

Plain Redux store implemented by the redux npm package, with redux-observable on top to provide Observables support. The package exposes createStore, createSelector, combineReducers, combineEpics, ofType, createEpicMiddleware, applyMiddleware and compose. This offers felxibility to either adopt one or both packages in the framework specific implementations of Midgard.

oAuth Client

Simple oAuth client which currently only supports credential based authentication provided through authenticateWithCredentials

Logging Library

Exposes a Logger class which can be instantiated with a few options which configure behavior:

• logToConsole - whether or not logged messages should be logged to the console as well
• logToServer - whether or not logged messages should be logged to the server as well
• APIURL - the server endpoint to send logged messages to. If this is not defined, logged messages will go to whatever endpoint was defined in environment variables for the deployment.

Logged messages can be categorized into various levels. Currently, those levels are LOG, TRACE, DEBUG, WARN, and ERROR. The logger will attempt to route messages to the correct console method, if it is available, based on the logLevel defined. Server side logging will also separate log messages based on these categories.