passkit-generator/fields.js

const schema = require("./schema");

/**
 * Class to represent lower-level keys pass fields
 * @see https://apple.co/2wkUBdh
 */

class FieldsContainer {
	constructor() {
		this._uniqueKeys = [];
		this.fields = [];
	}

	/**
	 * A wrapper of Array.prototype.push to validate the pushed content with the schema.
	 * Accepts also one array of objects.
	 *
	 * @method push
	 * @params {Object[]} fields - the fields to be checked and pushed
	 * @params {schema.field} fields[].* - each key must be compliant with schema.field structure
	 * @returns {Number} - the amount of pushed elements (for checks)
	 */

	push(...fieldsData) {
		if (fieldsData[0] instanceof Array && fieldsData[0].length) {
			fieldsData = fieldsData[0];
		}

		let validFields = fieldsData.filter(f => {
			if (this._uniqueKeys.includes(f.key)) {
				return false;
			}

			this._uniqueKeys.push(f.key);

			return typeof f === "object" && schema.isValid(f, "field");
		});

		this.fields.push(...validFields);

		return validFields.length;
	}

	/**
	 * A wrapper of Array.prototype.pop and Array.prototype.slice to pop
	 * last element or n elements starting from the end.
	 *
	 * @method pop
	 * @params {Number} [quantity=-1] - the amount of elements to be removed
	 * @returns {Number} - the amount of removed elements
	 */

	pop(amount = -1) {
		if (!this.fields.length) {
			return undefined;
		}

		if (amount > -1) {
			let removedElements = this.fields.slice(amount);
			this.fields = this.fields.slice(0, this.fields.length - amount);
			this._uniqueKeys = this._uniqueKeys.slice(0, this._uniqueKeys - amount);

			return removedElements;
		}

		this._uniqueKeys.pop();
		return this.fields.pop();
	}
}

module.exports = FieldsContainer;