Bootstrap.js

import $Helper from 'ima-helpers';
import ns from './namespace';
import ObjectContainer from './ObjectContainer';
import Router from './router/Router';

ns.namespace('ima');

/**
 * Environment name value in the production environment.
 *
 * @const
 * @type {string}
 */
const PRODUCTION_ENVIRONMENT = 'prod';

/**
 * Application bootstrap used to initialize the environment and the application
 * itself.
 */
export default class Bootstrap {
  /**
   * Initializes the bootstrap.
   *
   * @param {ObjectContainer} oc The application's object container to use
   *        for managing dependencies.
   */
  constructor(oc) {
    /**
     * The object container used to manage dependencies.
     *
     * @type {ObjectContainer}
     */
    this._oc = oc;

    /**
     * Application configuration.
     *
     * @type {Object<string, *>}
     */
    this._config = {};
  }

  /**
   * Initializes the application by running the bootstrap sequence. The
   * sequence initializes the components of the application in the following
   * order:
   * - application settings
   * - constants, service providers and class dependencies configuration
   * - services
   * - UI components
   * - routing
   *
   * @param {Object<string, *>} config The application environment
   *        configuration for the current environment.
   */
  run(config) {
    this._config = config;

    this._initSettings();
    this._bindDependencies();
    this._initServices();
    this._initRoutes();
  }

  /**
   * Initializes the application settings. The method loads the settings for
   * all environments and then pics the settings for the current environment.
   *
   * The method also handles using the values in the production environment
   * as default values for configuration items in other environments.
   */
  _initSettings() {
    let currentApplicationSettings = {};

    let plugins = this._config.plugins.concat([this._config]);

    plugins
      .filter(plugin => typeof plugin.initSettings === 'function')
      .forEach(plugin => {
        let allPluginSettings = plugin.initSettings(
          ns,
          this._oc,
          this._config.settings
        );
        let environmentPluginSetting = $Helper.resolveEnvironmentSetting(
          allPluginSettings,
          this._config.settings.$Env
        );

        $Helper.assignRecursively(
          currentApplicationSettings,
          environmentPluginSetting
        );
      });

    this._config.bind = Object.assign(
      this._config.bind || {},
      currentApplicationSettings,
      this._config.settings
    );
  }

  /**
   * Returns setting for current environment where base values are from production
   * environment and other environments override base values.
   *
   * @return {Object<string, *>}
   */
  _getEnvironmentSetting(allSettings) {
    let environment = this._config.settings.$Env;
    let environmentSetting = allSettings[environment] || {};

    if (environment !== PRODUCTION_ENVIRONMENT) {
      let productionSettings = allSettings[PRODUCTION_ENVIRONMENT];
      $Helper.assignRecursively(productionSettings, environmentSetting);
      environmentSetting = productionSettings;
    }

    return environmentSetting;
  }

  /**
   * Binds the constants, service providers and class dependencies to the
   * object container.
   */
  _bindDependencies() {
    this._oc.setBindingState(ObjectContainer.IMA_BINDING_STATE);
    this._config.initBindIma(ns, this._oc, this._config.bind);

    this._oc.setBindingState(ObjectContainer.PLUGIN_BINDING_STATE);
    this._config.plugins
      .filter(plugin => typeof plugin.initBind === 'function')
      .forEach(plugin => {
        plugin.initBind(ns, this._oc, this._config.bind);
      });

    this._oc.setBindingState(ObjectContainer.APP_BINDING_STATE);
    this._config.initBindApp(ns, this._oc, this._config.bind);
  }

  /**
   * Initializes the routes.
   */
  _initRoutes() {
    let router = this._oc.get(Router);
    this._config.initRoutes(ns, this._oc, this._config.routes, router);
  }

  /**
   * Initializes the basic application services.
   */
  _initServices() {
    this._config.initServicesIma(ns, this._oc, this._config.services);

    this._config.plugins
      .filter(plugin => typeof plugin.initServices === 'function')
      .forEach(plugin => {
        plugin.initServices(ns, this._oc, this._config.services);
      });

    this._config.initServicesApp(ns, this._oc, this._config.services);
  }
}

ns.ima.Bootstrap = Bootstrap;