@boost/config/mjs/Processor.mjs

Powerful convention based finder, loader, and manager of both configuration and ignore files.

function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : String(i); }
function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
import { Contract, isObject } from '@boost/common';
import { optimal } from '@boost/common/optimal';
import { createDebugger } from '@boost/debug';
import { color } from '@boost/internal';
import { mergeArray } from './helpers/mergeArray.mjs';
import { mergeObject } from './helpers/mergeObject.mjs';

/* eslint-disable no-await-in-loop */

class Processor extends Contract {
  constructor(options) {
    super(options);
    this.debug = void 0;
    // eslint-disable-next-line @typescript-eslint/no-explicit-any
    this.handlers = {};
    this.debug = createDebugger(['processor', this.options.name]);
  }
  blueprint(schemas) {
    const bool = schemas.bool,
      string = schemas.string;
    return {
      defaultWhenUndefined: bool(true),
      name: string().required().camelCase(),
      validate: bool(true)
    };
  }

  /**
   * Add a handler to process a key-value setting pair.
   */
  addHandler(key, handler) {
    this.debug('Adding process handler for %s', color.symbol(key));
    this.handlers[key] = handler;
    return this;
  }

  /**
   * Return a handler, or null, for the setting key.
   */
  getHandler(key) {
    return this.handlers[key] || null;
  }

  /**
   * Process a list of loaded config files into a single config object.
   * Use the defined process handlers, or the default processing rules,
   * to generate the final config object.
   */
  async process(defaults, configs, blueprint) {
    const _this$options = this.options,
      defaultWhenUndefined = _this$options.defaultWhenUndefined,
      validate = _this$options.validate;
    const config = _objectSpread({}, defaults);
    this.debug('Processing %d configs into a single and final result', configs.length);
    for (const next of configs) {
      // Validate next config object
      if (validate) {
        optimal(blueprint, {
          file: next.path.path()
        }).validate(next.config);
      }

      // Merge properties into previous object
      for (const _ref of Object.entries(next.config)) {
        var _ref2 = _slicedToArray(_ref, 2);
        const key = _ref2[0];
        const value = _ref2[1];
        const name = key;
        const nextValue = value;
        const prevValue = config[name];
        const handler = this.getHandler(name);
        if (handler) {
          config[name] = await handler(prevValue, nextValue);
        } else if (isObject(prevValue) && isObject(nextValue)) {
          config[name] = mergeObject(prevValue, nextValue);
        } else if (Array.isArray(prevValue) && Array.isArray(nextValue)) {
          config[name] = mergeArray(prevValue, nextValue);
        } else {
          config[name] = nextValue;
        }

        // Reset to default value if undefined is present
        if (config[name] === undefined && defaultWhenUndefined) {
          config[name] = defaults[name];
        }
      }
    }
    return config;
  }
}
export { Processor };
//# sourceMappingURL=Processor.mjs.map