@webex/internal-plugin-device 2.59.3-next.1 → 2.59.4

package/src/features/feature-collection.js

@@ -1,30 +1,30 @@
-// External dependencies.
-import AmpCollection from 'ampersand-collection';
-
-// Local Dependencies
-import FeatureModel from './feature-model';
-
-/**
- * Feature collection model.
- *
- * @description
- * This model contains a collection of features under a specific collection
- * group.
- */
-const FeatureCollection = AmpCollection.extend({
-  /**
-   * The unique identifier for the models in this collection.
-   *
-   * @type {string}
-   */
-  mainIndex: 'key',
-
-  /**
-   * The type of model this collection can contain.
-   *
-   * @type {Class}
-   */
-  model: FeatureModel,
-});
-
-export default FeatureCollection;
+// External dependencies.
+import AmpCollection from 'ampersand-collection';
+
+// Local Dependencies
+import FeatureModel from './feature-model';
+
+/**
+ * Feature collection model.
+ *
+ * @description
+ * This model contains a collection of features under a specific collection
+ * group.
+ */
+const FeatureCollection = AmpCollection.extend({
+  /**
+   * The unique identifier for the models in this collection.
+   *
+   * @type {string}
+   */
+  mainIndex: 'key',
+
+  /**
+   * The type of model this collection can contain.
+   *
+   * @type {Class}
+   */
+  model: FeatureModel,
+});
+
+export default FeatureCollection;

package/src/features/feature-model.js

@@ -1,189 +1,189 @@
-// External dependencies.
-import AmpState from 'ampersand-state';
-import {defaults, isObject} from 'lodash';
-
-import {FEATURE_TYPES} from '../constants';
-
-/**
- * The model returned from the {@link FeatureModel#parse} method.
- *
- * @typedef {Object} ParsedFeatureModel
- * @property {boolean|number|string} ParsedFeatureModel.value - The parsed val.
- * @property {string} ParsedFeatureModel.type - The type of the parsed val.
- */
-
-/**
- * Feature model.
- *
- * @description
- * This model contains details on a single feature and is received from the
- * **WDM** service upon registration.
- */
-const FeatureModel = AmpState.extend({
-  idAttribute: 'key', // needed by Ampersand to determine unique item
-
-  // Ampersand property members.
-
-  props: {
-    /**
-     * Contains the unique identifier for this feature to be addressed by.
-     *
-     * @type {string}
-     */
-    key: 'string',
-
-    /**
-     * This property contains the date in which this feature was last modified.
-     *
-     * @type {date}
-     */
-    lastModified: 'date',
-
-    /**
-     * This property defines whether or not the feature is mutable.
-     *
-     * @type {boolean}
-     */
-    mutable: 'boolean',
-
-    /**
-     * This property contains the data type the string value should be
-     * interpreted as.
-     *
-     * @type {FEATURE_TYPES}
-     */
-    type: 'string',
-
-    /**
-     * This property contains the string value of this feature.
-     *
-     * @type {string}
-     */
-    val: 'string',
-
-    /**
-     * This property contains the interpreted value of this feature.
-     *
-     * @type {any}
-     */
-    value: 'any',
-  },
-
-  /**
-   * Class object constructor. This method safely initializes the class object
-   * prior to it fully loading to allow data to be accessed and modified
-   * immediately after construction instead of initialization.
-   *
-   * @override
-   * @param {Object} attrs - An object to map against the feature's properties.
-   * @param {Object} [options={}] - Ampersand options for `parse` and `parent`.
-   */
-  constructor(attrs, options = {}) {
-    defaults(options, {parse: true});
-
-    return Reflect.apply(AmpState.prototype.constructor, this, [attrs, options]);
-  },
-
-  // Ampsersand method members.
-
-  /**
-   * Parse {@link FeatureModel} properties recieved as strings from **WDM**
-   * and cast them as their appropriate types.
-   *
-   * @private
-   * @memberof FeatureModel
-   * @param {Object} model - The model to parse.
-   * @property {string} model.val - The value to be parsed.
-   * @returns {ParsedFeatureModel} - The parsed model.
-   */
-  parse(model) {
-    // Validate that a model was provided and that it is an object.
-    if (!model || typeof model !== 'object') {
-      // Return an empty object to satisfy the requirements of `Ampersand`.
-      return {};
-    }
-
-    const parsedModel = {...model};
-    const {val} = parsedModel;
-
-    // Validate that the value is a number.
-    if (!Number.isNaN(Number(val))) {
-      parsedModel.type = FEATURE_TYPES.NUMBER;
-      parsedModel.value = Number(val);
-    }
-    // Validate if the value should be a true boolean.
-    else if (typeof val === 'string' && val.toLowerCase() === 'true') {
-      parsedModel.type = FEATURE_TYPES.BOOLEAN;
-      parsedModel.value = true;
-    }
-    // Validate if the value should be a false boolean.
-    else if (typeof val === 'string' && val.toLowerCase() === 'false') {
-      parsedModel.type = FEATURE_TYPES.BOOLEAN;
-      parsedModel.value = false;
-    }
-    // In all other cases, the value is string, even if it is undefined.
-    else {
-      parsedModel.type = FEATURE_TYPES.STRING;
-      parsedModel.value = val;
-    }
-
-    return parsedModel;
-  },
-
-  /**
-   * Serialize the feature using the parent ampersand method with its date as an
-   * ISO string. This converts the feature into a request-transportable object.
-   *
-   * @override
-   * @param  {Record<string,boolean>} [args] - List of properties to serialize.
-   * @returns {Object} - The request-ready transport object.
-   */
-  serialize(...args) {
-    // Call the overloaded class member.
-    const attrs = Reflect.apply(AmpState.prototype.serialize, this, args);
-
-    // Validate that the overloaded class member returned an object with the
-    // `lastModified` key-value pair and instance it as an ISO string.
-    if (attrs.lastModified) {
-      attrs.lastModified = new Date(attrs.lastModified).toISOString();
-    }
-
-    return attrs;
-  },
-
-  /**
-   * Set a property of this object to a specific value. This method utilizes
-   * code that exists within the `ampersand-state` dependency to handle
-   * scenarios in which `key = {"key": "value"}` or
-   * `key = "key", value = "value"`. Since the snippet is pulled directly from
-   * `ampersand-state`, there is no need to test both scenarios.
-   *
-   * @override
-   * @param {object | string} key - The key value, or object to be set.
-   * @param {any} value - The key value or object to set the keyed pair to.
-   * @param {any} options - The object to set the keyed pair to.
-   * @returns {any} - The changed property.
-   */
-  set(key, value, options) {
-    // Declare formatted output variables for properly setting the targetted
-    // property for this method.
-    let attrs;
-    let optns;
-
-    // Validate if the key is an instance of any object or not.
-    if (isObject(key) || key === null) {
-      attrs = key;
-      optns = value;
-    } else {
-      attrs = {};
-      attrs[key] = value;
-      optns = options;
-    }
-
-    attrs = this.parse(attrs, optns);
-
-    return Reflect.apply(AmpState.prototype.set, this, [attrs, optns]);
-  },
-});
-
-export default FeatureModel;
+// External dependencies.
+import AmpState from 'ampersand-state';
+import {defaults, isObject} from 'lodash';
+
+import {FEATURE_TYPES} from '../constants';
+
+/**
+ * The model returned from the {@link FeatureModel#parse} method.
+ *
+ * @typedef {Object} ParsedFeatureModel
+ * @property {boolean|number|string} ParsedFeatureModel.value - The parsed val.
+ * @property {string} ParsedFeatureModel.type - The type of the parsed val.
+ */
+
+/**
+ * Feature model.
+ *
+ * @description
+ * This model contains details on a single feature and is received from the
+ * **WDM** service upon registration.
+ */
+const FeatureModel = AmpState.extend({
+  idAttribute: 'key', // needed by Ampersand to determine unique item
+
+  // Ampersand property members.
+
+  props: {
+    /**
+     * Contains the unique identifier for this feature to be addressed by.
+     *
+     * @type {string}
+     */
+    key: 'string',
+
+    /**
+     * This property contains the date in which this feature was last modified.
+     *
+     * @type {date}
+     */
+    lastModified: 'date',
+
+    /**
+     * This property defines whether or not the feature is mutable.
+     *
+     * @type {boolean}
+     */
+    mutable: 'boolean',
+
+    /**
+     * This property contains the data type the string value should be
+     * interpreted as.
+     *
+     * @type {FEATURE_TYPES}
+     */
+    type: 'string',
+
+    /**
+     * This property contains the string value of this feature.
+     *
+     * @type {string}
+     */
+    val: 'string',
+
+    /**
+     * This property contains the interpreted value of this feature.
+     *
+     * @type {any}
+     */
+    value: 'any',
+  },
+
+  /**
+   * Class object constructor. This method safely initializes the class object
+   * prior to it fully loading to allow data to be accessed and modified
+   * immediately after construction instead of initialization.
+   *
+   * @override
+   * @param {Object} attrs - An object to map against the feature's properties.
+   * @param {Object} [options={}] - Ampersand options for `parse` and `parent`.
+   */
+  constructor(attrs, options = {}) {
+    defaults(options, {parse: true});
+
+    return Reflect.apply(AmpState.prototype.constructor, this, [attrs, options]);
+  },
+
+  // Ampsersand method members.
+
+  /**
+   * Parse {@link FeatureModel} properties recieved as strings from **WDM**
+   * and cast them as their appropriate types.
+   *
+   * @private
+   * @memberof FeatureModel
+   * @param {Object} model - The model to parse.
+   * @property {string} model.val - The value to be parsed.
+   * @returns {ParsedFeatureModel} - The parsed model.
+   */
+  parse(model) {
+    // Validate that a model was provided and that it is an object.
+    if (!model || typeof model !== 'object') {
+      // Return an empty object to satisfy the requirements of `Ampersand`.
+      return {};
+    }
+
+    const parsedModel = {...model};
+    const {val} = parsedModel;
+
+    // Validate that the value is a number.
+    if (!Number.isNaN(Number(val))) {
+      parsedModel.type = FEATURE_TYPES.NUMBER;
+      parsedModel.value = Number(val);
+    }
+    // Validate if the value should be a true boolean.
+    else if (typeof val === 'string' && val.toLowerCase() === 'true') {
+      parsedModel.type = FEATURE_TYPES.BOOLEAN;
+      parsedModel.value = true;
+    }
+    // Validate if the value should be a false boolean.
+    else if (typeof val === 'string' && val.toLowerCase() === 'false') {
+      parsedModel.type = FEATURE_TYPES.BOOLEAN;
+      parsedModel.value = false;
+    }
+    // In all other cases, the value is string, even if it is undefined.
+    else {
+      parsedModel.type = FEATURE_TYPES.STRING;
+      parsedModel.value = val;
+    }
+
+    return parsedModel;
+  },
+
+  /**
+   * Serialize the feature using the parent ampersand method with its date as an
+   * ISO string. This converts the feature into a request-transportable object.
+   *
+   * @override
+   * @param  {Record<string,boolean>} [args] - List of properties to serialize.
+   * @returns {Object} - The request-ready transport object.
+   */
+  serialize(...args) {
+    // Call the overloaded class member.
+    const attrs = Reflect.apply(AmpState.prototype.serialize, this, args);
+
+    // Validate that the overloaded class member returned an object with the
+    // `lastModified` key-value pair and instance it as an ISO string.
+    if (attrs.lastModified) {
+      attrs.lastModified = new Date(attrs.lastModified).toISOString();
+    }
+
+    return attrs;
+  },
+
+  /**
+   * Set a property of this object to a specific value. This method utilizes
+   * code that exists within the `ampersand-state` dependency to handle
+   * scenarios in which `key = {"key": "value"}` or
+   * `key = "key", value = "value"`. Since the snippet is pulled directly from
+   * `ampersand-state`, there is no need to test both scenarios.
+   *
+   * @override
+   * @param {object | string} key - The key value, or object to be set.
+   * @param {any} value - The key value or object to set the keyed pair to.
+   * @param {any} options - The object to set the keyed pair to.
+   * @returns {any} - The changed property.
+   */
+  set(key, value, options) {
+    // Declare formatted output variables for properly setting the targetted
+    // property for this method.
+    let attrs;
+    let optns;
+
+    // Validate if the key is an instance of any object or not.
+    if (isObject(key) || key === null) {
+      attrs = key;
+      optns = value;
+    } else {
+      attrs = {};
+      attrs[key] = value;
+      optns = options;
+    }
+
+    attrs = this.parse(attrs, optns);
+
+    return Reflect.apply(AmpState.prototype.set, this, [attrs, optns]);
+  },
+});
+
+export default FeatureModel;

package/src/features/features-model.js

@@ -1,96 +1,96 @@
-// External dependencies.
-import AmpState from 'ampersand-state';
-
-// Local Dependencies
-import {FEATURE_COLLECTION_NAMES} from '../constants';
-
-import FeatureCollection from './feature-collection';
-
-/**
- * Feature collection parent container.
- *
- * @description
- * This class contains all of the feature collection class objects to help
- * organize the data retrieved from the **wdm** service on device registration.
- */
-const FeaturesModel = AmpState.extend({
-  // Ampersand property members.
-
-  collections: {
-    /**
-     * This collection contains the developer feature collection.
-     *
-     * @type {FeatureCollection}
-     */
-    developer: FeatureCollection,
-
-    /**
-     * This collection contains the entitlement feature collection.
-     *
-     * @type {FeatureCollection}
-     */
-    entitlement: FeatureCollection,
-
-    /**
-     * This collection contains the user feature collection.
-     *
-     * @type {FeatureCollection}
-     */
-    user: FeatureCollection,
-  },
-
-  // Helper method members.
-
-  /**
-   * Recursively clear attributes, children, and collections.
-   *
-   * @param {Object} options - Attribute options to unset.
-   * @returns {this}
-   */
-  clear(options) {
-    // Clear the ampersand attributes safely if there are any. This class should
-    // never have any attributes.
-    Object.keys(this.attributes).forEach((key) => {
-      this.unset(key, options);
-    });
-
-    // Clear the ampersand children safely if there are any. This class should
-    // never have any children.
-    /* eslint-disable-next-line no-underscore-dangle */
-    Object.keys(this._children).forEach((key) => {
-      this[key].clear();
-    });
-
-    // Clear the ampersand collections safely.
-    /* eslint-disable-next-line no-underscore-dangle */
-    Object.keys(this._collections).forEach((key) => {
-      this[key].reset();
-    });
-
-    return this;
-  },
-
-  // Ampersand method members.
-
-  /**
-   * Initializer method for FeatureModel class object.
-   *
-   * @override
-   * @returns {void}
-   */
-  initialize() {
-    // Declare the collection event names.
-    const eventNames = ['change:value', 'add', 'remove'];
-
-    // Initialize collection event listeners.
-    eventNames.forEach((eventName) => {
-      FEATURE_COLLECTION_NAMES.forEach((collectionName) => {
-        this[collectionName].on(eventName, (model, options) => {
-          this.trigger(`change:${collectionName}`, this, this[collectionName], options);
-        });
-      });
-    });
-  },
-});
-
-export default FeaturesModel;
+// External dependencies.
+import AmpState from 'ampersand-state';
+
+// Local Dependencies
+import {FEATURE_COLLECTION_NAMES} from '../constants';
+
+import FeatureCollection from './feature-collection';
+
+/**
+ * Feature collection parent container.
+ *
+ * @description
+ * This class contains all of the feature collection class objects to help
+ * organize the data retrieved from the **wdm** service on device registration.
+ */
+const FeaturesModel = AmpState.extend({
+  // Ampersand property members.
+
+  collections: {
+    /**
+     * This collection contains the developer feature collection.
+     *
+     * @type {FeatureCollection}
+     */
+    developer: FeatureCollection,
+
+    /**
+     * This collection contains the entitlement feature collection.
+     *
+     * @type {FeatureCollection}
+     */
+    entitlement: FeatureCollection,
+
+    /**
+     * This collection contains the user feature collection.
+     *
+     * @type {FeatureCollection}
+     */
+    user: FeatureCollection,
+  },
+
+  // Helper method members.
+
+  /**
+   * Recursively clear attributes, children, and collections.
+   *
+   * @param {Object} options - Attribute options to unset.
+   * @returns {this}
+   */
+  clear(options) {
+    // Clear the ampersand attributes safely if there are any. This class should
+    // never have any attributes.
+    Object.keys(this.attributes).forEach((key) => {
+      this.unset(key, options);
+    });
+
+    // Clear the ampersand children safely if there are any. This class should
+    // never have any children.
+    /* eslint-disable-next-line no-underscore-dangle */
+    Object.keys(this._children).forEach((key) => {
+      this[key].clear();
+    });
+
+    // Clear the ampersand collections safely.
+    /* eslint-disable-next-line no-underscore-dangle */
+    Object.keys(this._collections).forEach((key) => {
+      this[key].reset();
+    });
+
+    return this;
+  },
+
+  // Ampersand method members.
+
+  /**
+   * Initializer method for FeatureModel class object.
+   *
+   * @override
+   * @returns {void}
+   */
+  initialize() {
+    // Declare the collection event names.
+    const eventNames = ['change:value', 'add', 'remove'];
+
+    // Initialize collection event listeners.
+    eventNames.forEach((eventName) => {
+      FEATURE_COLLECTION_NAMES.forEach((collectionName) => {
+        this[collectionName].on(eventName, (model, options) => {
+          this.trigger(`change:${collectionName}`, this, this[collectionName], options);
+        });
+      });
+    });
+  },
+});
+
+export default FeaturesModel;

package/src/features/index.js

@@ -1,5 +1,5 @@
-import FeatureCollection from './feature-collection';
-import FeatureModel from './feature-model';
-import FeaturesModel from './features-model';
-
-export {FeatureCollection, FeatureModel, FeaturesModel};
+import FeatureCollection from './feature-collection';
+import FeatureModel from './feature-model';
+import FeaturesModel from './features-model';
+
+export {FeatureCollection, FeatureModel, FeaturesModel};