@soundworks/core 3.6.0 → 4.0.0-alpha.0

package/{common → src/common}/ParameterBag.js

@@ -1,18 +1,5 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.types = exports.sharedOptions = exports.default = void 0;
-
-var _lodash = _interopRequireDefault(require("lodash.clonedeep"));
-
-var _fastDeepEqual = _interopRequireDefault(require("fast-deep-equal"));
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-// import types from './types';
-// import shallowClone from 'shallow-clone';
+import cloneDeep from 'lodash.clonedeep';
+import equal from 'fast-deep-equal';
 
 /**
  * @typedef {Object} server.SharedStateManagerServer~schema
@@ -44,7 +31,6 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
  *   }
  * }
  */
-
 /**
  * @typedef {Object} server.SharedStateManagerServer~schemaBooleanDef
  *
@@ -62,15 +48,14 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
  *   (which has no state per se). As such, setting this options to `false` if
  *   `event=true` does not make sens.
  * @property {Boolean} [immediate=false] - Setting this option to `true` will
- *   trigger any change (e.g. call the subscribe listeners) immediately on the
+ *   trigger any change (e.g. call the `onUpdate` listeners) immediately on the
  *   state that generate the update (i.e. calling `set`), before propagating the
  *   change on the network. This option can be usefull in cases the network
  *   would introduce a noticeable latency on the client. If for some reason
- *   the value is overriden server-side (e.g. in an updateHook) the listeners
+ *   the value is overriden server-side (e.g. in an `updateHook`) the listeners
  *   will be called again on when the "real" / final value will be received.
  * @property {Object} [metas={}] - Optionnal metadata of the parameter.
  */
-
 /**
  * @typedef {Object} server.SharedStateManagerServer~schemaStringDef
  *
@@ -88,15 +73,14 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
  *   (which has no state per se). As such, setting this options to `false` if
  *   `event=true` does not make sens.
  * @property {Boolean} [immediate=false] - Setting this option to `true` will
- *   trigger any change (e.g. call the subscribe listeners) immediately on the
+ *   trigger any change (e.g. call the `onUpdate` listeners) immediately on the
  *   state that generate the update (i.e. calling `set`), before propagating the
  *   change on the network. This option can be usefull in cases the network
  *   would introduce a noticeable latency on the client. If for some reason
- *   the value is overriden server-side (e.g. in an updateHook) the listeners
+ *   the value is overriden server-side (e.g. in an `updateHook`) the listeners
  *   will be called again on when the "real" / final value will be received.
  * @property {Object} [metas={}] - Optionnal metadata of the parameter.
  */
-
 /**
  @typedef {Object} server.SharedStateManagerServer~schemaIntegerDef
  *
@@ -116,15 +100,14 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
  *   (which has no state per se). As such, setting this options to `false` if
  *   `event=true` does not make sens.
  * @property {Boolean} [immediate=false] - Setting this option to `true` will
- *   trigger any change (e.g. call the subscribe listeners) immediately on the
+ *   trigger any change (e.g. call the `onUpdate` listeners) immediately on the
  *   state that generate the update (i.e. calling `set`), before propagating the
  *   change on the network. This option can be usefull in cases the network
  *   would introduce a noticeable latency on the client. If for some reason
- *   the value is overriden server-side (e.g. in an updateHook) the listeners
+ *   the value is overriden server-side (e.g. in an `updateHook`) the listeners
  *   will be called again on when the "real" / final value will be received.
  * @property {Object} [metas={}] - Optionnal metadata of the parameter.
  */
-
 /**
  * @typedef {Object} server.SharedStateManagerServer~schemaFloatDef
  *
@@ -144,15 +127,14 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
  *   (which has no state per se). As such, setting this options to `false` if
  *   `event=true` does not make sens.
  * @property {Boolean} [immediate=false] - Setting this option to `true` will
- *   trigger any change (e.g. call the subscribe listeners) immediately on the
+ *   trigger any change (e.g. call the `onUpdate` listeners) immediately on the
  *   state that generate the update (i.e. calling `set`), before propagating the
  *   change on the network. This option can be usefull in cases the network
  *   would introduce a noticeable latency on the client. If for some reason
- *   the value is overriden server-side (e.g. in an updateHook) the listeners
+ *   the value is overriden server-side (e.g. in an `updateHook`) the listeners
  *   will be called again on when the "real" / final value will be received.
  * @property {Object} [metas={}] - Optionnal metadata of the parameter.
  */
-
 /**
  * @typedef {Object} server.SharedStateManagerServer~schemaEnumDef
  *
@@ -171,15 +153,14 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
  *   (which has no state per se). As such, setting this options to `false` if
  *   `event=true` does not make sens.
  * @property {Boolean} [immediate=false] - Setting this option to `true` will
- *   trigger any change (e.g. call the subscribe listeners) immediately on the
+ *   trigger any change (e.g. call the `onUpdate` listeners) immediately on the
  *   state that generate the update (i.e. calling `set`), before propagating the
  *   change on the network. This option can be usefull in cases the network
  *   would introduce a noticeable latency on the client. If for some reason
- *   the value is overriden server-side (e.g. in an updateHook) the listeners
+ *   the value is overriden server-side (e.g. in an `updateHook`) the listeners
  *   will be called again on when the "real" / final value will be received.
  * @property {Object} [metas={}] - Optionnal metadata of the parameter.
  */
-
 /**
  * @typedef {Object} server.SharedStateManagerServer~schemaAnyDef
  *
@@ -200,65 +181,59 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
  *   (which has no state per se). As such, setting this options to `false` if
  *   `event=true` does not make sens.
  * @property {Boolean} [immediate=false] - Setting this option to `true` will
- *   trigger any change (e.g. call the subscribe listeners) immediately on the
+ *   trigger any change (e.g. call the `onUpdate` listeners) immediately on the
  *   state that generate the update (i.e. calling `set`), before propagating the
  *   change on the network. This option can be usefull in cases the network
  *   would introduce a noticeable latency on the client. If for some reason
- *   the value is overriden server-side (e.g. in an updateHook) the listeners
+ *   the value is overriden server-side (e.g. in an `updateHook`) the listeners
  *   will be called again on when the "real" / final value will be received.
  * @property {Object} [metas={}] - Optionnal metadata of the parameter.
  */
-const sharedOptions = {
+
+export const sharedOptions = {
   nullable: false,
-  event: false,
-  // if event=true, nullable=true
+  event: false, // if event=true, nullable=true
   metas: {},
   filterChange: true,
-  immediate: false
+  immediate: false,
 };
-exports.sharedOptions = sharedOptions;
-const types = {
+
+export const types = {
   boolean: {
     required: ['default'],
-
     get defaultOptions() {
-      return Object.assign((0, _lodash.default)(sharedOptions), {});
+      return Object.assign(cloneDeep(sharedOptions), {});
     },
-
     coerceFunction: (name, def, value) => {
       if (typeof value !== 'boolean') {
         throw new TypeError(`[stateManager] Invalid value for boolean param "${name}": ${value}`);
       }
 
       return value;
-    }
+    },
   },
   string: {
     required: ['default'],
-
     get defaultOptions() {
-      return Object.assign((0, _lodash.default)(sharedOptions), {});
+      return Object.assign(cloneDeep(sharedOptions), {});
     },
-
     coerceFunction: (name, def, value) => {
       if (typeof value !== 'string') {
         throw new TypeError(`[stateManager] Invalid value for string param "${name}": ${value}`);
       }
 
       return value;
-    }
+    },
   },
   integer: {
     required: ['default'],
-
     get defaultOptions() {
-      return Object.assign((0, _lodash.default)(sharedOptions), {
+      return Object.assign(cloneDeep(sharedOptions), {
         min: -Infinity,
-        max: +Infinity
+        max: +Infinity,
       });
     },
-
-    sanitizeSchema: def => {
+    sanitizeSchema: (def) => {
       // sanitize `null` values in received schema, this prevent a bug when
       // `min` and `max` are explicitely set to `±Infinity`, the schema is stringified
       // when sent over the network and therefore Infinity is transformed to `null`
@@ -281,19 +256,17 @@ const types = {
       }
 
       return Math.max(def.min, Math.min(def.max, value));
-    }
+    },
   },
   float: {
     required: ['default'],
-
     get defaultOptions() {
-      return Object.assign((0, _lodash.default)(sharedOptions), {
+      return Object.assign(cloneDeep(sharedOptions), {
         min: -Infinity,
-        max: +Infinity
+        max: +Infinity,
       });
     },
-
-    sanitizeSchema: def => {
+    sanitizeSchema: (def) => {
       // sanitize `null` values in received schema, this prevent a bug when
       // `min` and `max` are explicitely set to `±Infinity`, the schema is stringified
       // when sent over the network and therefore Infinity is transformed to `null`
@@ -311,66 +284,63 @@ const types = {
       return def;
     },
     coerceFunction: (name, def, value) => {
-      if (typeof value !== 'number' || value !== value) {
-        // reject NaN
+      if (typeof value !== 'number' || value !== value) { // reject NaN
         throw new TypeError(`[stateManager] Invalid value for float param "${name}": ${value}`);
       }
 
       return Math.max(def.min, Math.min(def.max, value));
-    }
+    },
   },
   enum: {
     required: ['default', 'list'],
-
     get defaultOptions() {
-      return Object.assign((0, _lodash.default)(sharedOptions), {});
+      return Object.assign(cloneDeep(sharedOptions), {});
     },
-
     coerceFunction: (name, def, value) => {
       if (def.list.indexOf(value) === -1) {
         throw new TypeError(`[stateManager] Invalid value for enum param "${name}": ${value}`);
       }
 
+
       return value;
-    }
+    },
   },
   any: {
     required: ['default'],
-
     get defaultOptions() {
-      return Object.assign((0, _lodash.default)(sharedOptions), {});
+      return Object.assign(cloneDeep(sharedOptions), {});
     },
-
     coerceFunction: (name, def, value) => {
       // no check as it can have any type...
       return value;
-    }
-  }
+    },
+  },
 };
+
+
 /**
  * Bag of parameters.
  * @private
  */
-
-exports.types = types;
-
 class ParameterBag {
   static validateSchema(schema) {
     for (let name in schema) {
       const def = schema[name];
 
-      if (!def.hasOwnProperty('type')) {
+      if (!Object.prototype.hasOwnProperty.call(def, 'type')) {
         throw new TypeError(`[stateManager] Invalid schema definition - param "${name}": "type" key is required`);
       }
 
-      if (!types.hasOwnProperty(def.type)) {
+      if (!Object.prototype.hasOwnProperty.call(types, def.type)) {
         throw new TypeError(`[stateManager] Invalid schema definition - param "${name}": "{ type: '${def.type}' }" does not exists`);
       }
 
       const required = types[def.type].required;
-      required.forEach(function (key) {
-        if (def.event === true && key === 'default') {// do nothing, default is always null for `event` params
-        } else if (!def.hasOwnProperty(key)) {
+
+      required.forEach(key => {
+        if (def.event === true && key === 'default') {
+          // do nothing, default is always null for `event` params
+        } else if (!Object.prototype.hasOwnProperty.call(def, key)) {
           throw new TypeError(`[stateManager] Invalid schema definition - param "${name}" (type "${def.type}"): "${key}" key is required`);
         }
       });
@@ -382,8 +352,9 @@ class ParameterBag {
       throw new Error(`[stateManager] schema is mandatory`);
     }
 
-    schema = (0, _lodash.default)(schema);
-    initValues = (0, _lodash.default)(initValues);
+    schema = cloneDeep(schema);
+    initValues = cloneDeep(initValues);
+
     /**
      * List of parameters.
      *
@@ -393,8 +364,8 @@ class ParameterBag {
      * @instance
      * @private
      */
-
     this._values = {};
+
     /**
      * List of schema with init values.
      *
@@ -404,29 +375,26 @@ class ParameterBag {
      * @instance
      * @private
      */
-
     this._schema = {};
-    ParameterBag.validateSchema(schema); // make shure initValues make sens according to the given schema
 
+    ParameterBag.validateSchema(schema);
+
+    // make shure initValues make sens according to the given schema
     for (let name in initValues) {
-      if (!schema.hasOwnProperty(name)) {
+      if (!Object.prototype.hasOwnProperty.call(schema, name)) {
         throw new ReferenceError(`[stateManager] init value defined for undefined param "${name}"`);
       }
     }
 
     for (let [name, def] of Object.entries(schema)) {
-      const {
-        defaultOptions,
-        coerceFunction
-      } = types[def.type];
-
       if (types[def.type].sanitizeSchema) {
         def = types[def.type].sanitizeSchema(def);
       }
 
-      def = Object.assign({}, defaultOptions, def); // if event property is set to true, the param must
+      const { defaultOptions } = types[def.type];
+      def = Object.assign({}, defaultOptions, def);
+      // if event property is set to true, the param must
       // be nullable and its default value is `undefined`
-
       if (def.event === true) {
         def.nullable = true;
         def.default = null;
@@ -434,37 +402,38 @@ class ParameterBag {
 
       let initValue;
 
-      if (initValues.hasOwnProperty(name)) {
+      if (Object.prototype.hasOwnProperty.call(initValues, name)) {
         initValue = initValues[name];
       } else {
         initValue = def.default;
       }
 
-      this._schema[name] = def; // coerce init value and store in definition
 
+      this._schema[name] = def;
+      // coerce init value and store in definition
       initValue = this.set(name, initValue)[0];
+
       this._schema[name].initValue = initValue;
       this._values[name] = initValue;
+
     }
   }
+
   /**
    * Define if the parameter exists.
    *
    * @param {String} name - Name of the parameter.
    * @return {Boolean}
    */
-
-
   has(name) {
-    return this._schema.hasOwnProperty(name);
+    return Object.prototype.hasOwnProperty.call(this._schema, name);
   }
+
   /**
    * Return values of all parameters as a flat object.
    *
    * @return {Object}
    */
-
-
   getValues() {
     let values = {};
 
@@ -474,6 +443,7 @@ class ParameterBag {
 
     return values;
   }
+
   /**
    * Return the value of the given parameter. If the parameter is of `any` type,
    * a deep copy is returned.
@@ -481,19 +451,18 @@ class ParameterBag {
    * @param {String} name - Name of the parameter.
    * @return {Mixed} - Value of the parameter.
    */
-
-
   get(name) {
     if (!this.has(name)) {
       throw new ReferenceError(`[stateManager] Cannot get value of undefined parameter "${name}"`);
     }
 
     if (this._schema[name].type === 'any') {
-      return (0, _lodash.default)(this._values[name]);
+      return cloneDeep(this._values[name]);
     } else {
       return this._values[name];
     }
   }
+
   /**
    * Set the value of a parameter. If the value of the parameter is updated
    * (aka if previous value is different from new value) all registered
@@ -505,32 +474,31 @@ class ParameterBag {
    *    if the value has not changed.
    * @return {Array} - [new value, updated flag].
    */
-
-
   set(name, value) {
     if (!this.has(name)) {
       throw new ReferenceError(`[stateManager] Cannot set value of undefined parameter "${name}"`);
     }
 
     const def = this._schema[name];
-    const {
-      coerceFunction
-    } = types[def.type];
+    const { coerceFunction } = types[def.type];
 
     if (value === null && def.nullable === false) {
       throw new TypeError(`[stateManager] Invalid value for ${def.type} param "${name}": value is null and param is not nullable`);
     } else if (value === null && def.nullable === true) {
-      value = value;
+      value = null;
     } else {
       value = coerceFunction(name, def, value);
     }
 
     const currentValue = this._values[name];
-    const updated = !(0, _fastDeepEqual.default)(currentValue, value);
-    this._values[name] = value; // return tuple so that the state manager can handle the `filterChange` option
+    const updated = !equal(currentValue, value);
+
+    this._values[name] = value;
 
+    // return tuple so that the state manager can handle the `filterChange` option
     return [value, updated];
   }
+
   /**
    * Reset a parameter to its initialization values. Reset all parameters if no argument.
    * @note - prefer `state.set(state.getInitValues())`
@@ -553,8 +521,6 @@ class ParameterBag {
    *
    * @return {Object}
    */
-
-
   getSchema(name = null) {
     if (name === null) {
       return this._schema;
@@ -565,31 +531,25 @@ class ParameterBag {
 
       return this._schema[name];
     }
-  } // return the default value, if initValue has been given, return init values
-
+  }
 
+  // return the default value, if initValue has been given, return init values
   getInitValues() {
     const initValues = {};
-
     for (let [name, def] of Object.entries(this._schema)) {
       initValues[name] = def.initValue;
     }
-
     return initValues;
-  } // return the default value, if initValue has been given, return init values
-
+  }
 
+  // return the default value, if initValue has been given, return init values
   getDefaults() {
     const defaults = {};
-
     for (let [name, def] of Object.entries(this._schema)) {
       defaults[name] = def.defaults;
     }
-
     return defaults;
   }
-
 }
 
-var _default = ParameterBag;
-exports.default = _default;
+export default ParameterBag;