/** * @fileoverview Defines a storage for rules. * @author Nicholas C. Zakas * @author aladdin-add */ "use strict"; //------------------------------------------------------------------------------ // Requirements //------------------------------------------------------------------------------ const builtInRules = require("../rules"); //------------------------------------------------------------------------------ // Helpers //------------------------------------------------------------------------------ /** * Normalizes a rule module to the new-style API * @param {(Function|{create: Function})} rule A rule object, which can either be a function * ("old-style") or an object with a `create` method ("new-style") * @returns {{create: Function}} A new-style rule. */ function normalizeRule(rule) { return typeof rule === "function" ? Object.assign({ create: rule }, rule) : rule; } //------------------------------------------------------------------------------ // Public Interface //------------------------------------------------------------------------------ class Rules { constructor() { this._rules = Object.create(null); } /** * Registers a rule module for rule id in storage. * @param {string} ruleId Rule id (file name). * @param {Function} ruleModule Rule handler. * @returns {void} */ define(ruleId, ruleModule) { this._rules[ruleId] = normalizeRule(ruleModule); } /** * Access rule handler by id (file name). * @param {string} ruleId Rule id (file name). * @returns {{create: Function, schema: JsonSchema[]}} * A rule. This is normalized to always have the new-style shape with a `create` method. */ get(ruleId) { if (typeof this._rules[ruleId] === "string") { this.define(ruleId, require(this._rules[ruleId])); } if (this._rules[ruleId]) { return this._rules[ruleId]; } if (builtInRules.has(ruleId)) { return builtInRules.get(ruleId); } return null; } *[Symbol.iterator]() { yield* builtInRules; for (const ruleId of Object.keys(this._rules)) { yield [ruleId, this.get(ruleId)]; } } } module.exports = Rules;