@webex/common 2.59.1 → 2.59.3-next.1

package/src/one-flight.js

@@ -1,89 +1,89 @@
-/*!
- * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
- */
-
-import {wrap} from 'lodash';
-
-import make from './template-container';
-
-// Alias Map and WeakMap to get around a babel compiler bug
-const W = WeakMap;
-const M = Map;
-const WeakMappedMappedMap = make(W, M, M);
-
-const flights = new WeakMappedMappedMap();
-
-/**
- * @memberof Util
- * @param {Object} options
- * @param {Function} options.keyFactory
- * @param {boolean} options.cacheFailures
- * @param {boolean} options.cacheSuccesses
- * @returns {Function}
- */
-export default function oneFlight(...params) {
-  if (params.length === 3) {
-    return Reflect.apply(oneFlightDecorator, null, params);
-  }
-
-  const options = params[0] || {};
-
-  const {cacheFailures, cacheSuccesses, keyFactory} = options;
-
-  return oneFlightDecorator;
-
-  /**
-   * @param {Object} target
-   * @param {string} prop
-   * @param {Object} descriptor
-   * @private
-   * @returns {Object}
-   */
-  function oneFlightDecorator(target, prop, descriptor) {
-    const key = prop;
-
-    descriptor.value = wrap(descriptor.value, function oneFlightExecutor(fn, ...args) {
-      let innerKey = key;
-
-      if (keyFactory) {
-        innerKey = `${innerKey}_${keyFactory(...args)}`;
-      }
-
-      /* eslint no-invalid-this: [0] */
-      let flight = flights.get(this, target, innerKey);
-
-      if (flight) {
-        return flight;
-      }
-
-      flight = Reflect.apply(fn, this, args);
-      if (!cacheFailures && flight && flight.catch) {
-        flight = flight.catch((reason) => {
-          flights.delete(this, target, innerKey);
-
-          return Promise.reject(reason);
-        });
-      }
-
-      if (!cacheSuccesses && flight && flight.then) {
-        flight = flight.then((result) => {
-          flights.delete(this, target, innerKey);
-
-          return result;
-        });
-      }
-
-      flights.set(this, target, innerKey, flight);
-
-      return flight;
-    });
-
-    // This *should* make decorators compatible with AmpersandState class
-    // definitions
-    if (typeof target === 'object' && !target.prototype) {
-      target[prop] = descriptor.value;
-    }
-
-    return descriptor;
-  }
-}
+/*!
+ * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
+ */
+
+import {wrap} from 'lodash';
+
+import make from './template-container';
+
+// Alias Map and WeakMap to get around a babel compiler bug
+const W = WeakMap;
+const M = Map;
+const WeakMappedMappedMap = make(W, M, M);
+
+const flights = new WeakMappedMappedMap();
+
+/**
+ * @memberof Util
+ * @param {Object} options
+ * @param {Function} options.keyFactory
+ * @param {boolean} options.cacheFailures
+ * @param {boolean} options.cacheSuccesses
+ * @returns {Function}
+ */
+export default function oneFlight(...params) {
+  if (params.length === 3) {
+    return Reflect.apply(oneFlightDecorator, null, params);
+  }
+
+  const options = params[0] || {};
+
+  const {cacheFailures, cacheSuccesses, keyFactory} = options;
+
+  return oneFlightDecorator;
+
+  /**
+   * @param {Object} target
+   * @param {string} prop
+   * @param {Object} descriptor
+   * @private
+   * @returns {Object}
+   */
+  function oneFlightDecorator(target, prop, descriptor) {
+    const key = prop;
+
+    descriptor.value = wrap(descriptor.value, function oneFlightExecutor(fn, ...args) {
+      let innerKey = key;
+
+      if (keyFactory) {
+        innerKey = `${innerKey}_${keyFactory(...args)}`;
+      }
+
+      /* eslint no-invalid-this: [0] */
+      let flight = flights.get(this, target, innerKey);
+
+      if (flight) {
+        return flight;
+      }
+
+      flight = Reflect.apply(fn, this, args);
+      if (!cacheFailures && flight && flight.catch) {
+        flight = flight.catch((reason) => {
+          flights.delete(this, target, innerKey);
+
+          return Promise.reject(reason);
+        });
+      }
+
+      if (!cacheSuccesses && flight && flight.then) {
+        flight = flight.then((result) => {
+          flights.delete(this, target, innerKey);
+
+          return result;
+        });
+      }
+
+      flights.set(this, target, innerKey, flight);
+
+      return flight;
+    });
+
+    // This *should* make decorators compatible with AmpersandState class
+    // definitions
+    if (typeof target === 'object' && !target.prototype) {
+      target[prop] = descriptor.value;
+    }
+
+    return descriptor;
+  }
+}

package/src/patterns.js

@@ -1,51 +1,51 @@
-/*!
- * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
- */
-
-/**
- * @description Set of regex patterns to compile once and use throughout the
- * app. All non-prefixed patterns have start/end characters to ensure exact
- * matches. Patterns prefixed with "exec" are the same as their non-prefixed
- * counterparts but without the start/end characters so they can be used with
- * methods like `RegExp#exec`.
- */
-export default {
-  /**
-   * Regular express that validates a string is strictly an email.
-   * Allows for validation of emails within services such as conversation
-   * activities or user details.
-   * See [RegEx information here]{@link https://ihateregex.io/expr/email-2}.
-   *
-   * @type {RegExp}
-   */
-  email:
-    /^(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/,
-
-  /**
-   * Regular expression that validates an ambiguous string contains emails
-   * (one or more) within.
-   * See [RegEx information here]{@link https://ihateregex.io/expr/email-2}.
-   *
-   * @type {RegExp}
-   */
-  containsEmails:
-    /(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))/g,
-
-  /**
-   * Matches a UUID
-   * @type {RegExp}
-   */
-  uuid: /^[a-f\d]{8}(?:-[a-f\d]{4}){3}-[a-f\d]{12}$/,
-
-  /**
-   * Same as this.email, but allows for surrounding characters
-   * @type {RegExp}
-   */
-  execEmail: /[^\s]+?@[^\s]+?/,
-
-  /**
-   * Same as this.uuid but allows for surrounding characters
-   * @type {RegExp}
-   */
-  execUuid: /[a-f\d]{8}(?:-[a-f\d]{4}){3}-[a-f\d]{12}/,
-};
+/*!
+ * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
+ */
+
+/**
+ * @description Set of regex patterns to compile once and use throughout the
+ * app. All non-prefixed patterns have start/end characters to ensure exact
+ * matches. Patterns prefixed with "exec" are the same as their non-prefixed
+ * counterparts but without the start/end characters so they can be used with
+ * methods like `RegExp#exec`.
+ */
+export default {
+  /**
+   * Regular express that validates a string is strictly an email.
+   * Allows for validation of emails within services such as conversation
+   * activities or user details.
+   * See [RegEx information here]{@link https://ihateregex.io/expr/email-2}.
+   *
+   * @type {RegExp}
+   */
+  email:
+    /^(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/,
+
+  /**
+   * Regular expression that validates an ambiguous string contains emails
+   * (one or more) within.
+   * See [RegEx information here]{@link https://ihateregex.io/expr/email-2}.
+   *
+   * @type {RegExp}
+   */
+  containsEmails:
+    /(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))/g,
+
+  /**
+   * Matches a UUID
+   * @type {RegExp}
+   */
+  uuid: /^[a-f\d]{8}(?:-[a-f\d]{4}){3}-[a-f\d]{12}$/,
+
+  /**
+   * Same as this.email, but allows for surrounding characters
+   * @type {RegExp}
+   */
+  execEmail: /[^\s]+?@[^\s]+?/,
+
+  /**
+   * Same as this.uuid but allows for surrounding characters
+   * @type {RegExp}
+   */
+  execUuid: /[a-f\d]{8}(?:-[a-f\d]{4}){3}-[a-f\d]{12}/,
+};

package/src/resolve-with.js

@@ -1,27 +1,27 @@
-/*!
- * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
- */
-
-/**
- * Sugar method for returning the desired object at the end of a promise chain
- * @param {any} object the item with which to resolve the promise chain
- * @returns {function}
- * @example
- * var item = {
- *   prop: 2
- * };
- * Promise
- *  .resolve(item.prop)
- *  .then(resolveWith(item))
- *  .then(function(res) {
- *    require('assert').deepEqual(res, {prop:2});
- *    return 'success'
- *  })
- *  // => success
- *
- */
-export default function resolveWith(object) {
-  return function resolver() {
-    return Promise.resolve(object);
-  };
-}
+/*!
+ * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
+ */
+
+/**
+ * Sugar method for returning the desired object at the end of a promise chain
+ * @param {any} object the item with which to resolve the promise chain
+ * @returns {function}
+ * @example
+ * var item = {
+ *   prop: 2
+ * };
+ * Promise
+ *  .resolve(item.prop)
+ *  .then(resolveWith(item))
+ *  .then(function(res) {
+ *    require('assert').deepEqual(res, {prop:2});
+ *    return 'success'
+ *  })
+ *  // => success
+ *
+ */
+export default function resolveWith(object) {
+  return function resolver() {
+    return Promise.resolve(object);
+  };
+}

package/src/retry.js

@@ -1,124 +1,124 @@
-/*!
- * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
- */
-
-import {EventEmitter} from 'events';
-
-import {defaults, isFunction, wrap} from 'lodash';
-import backoff from 'backoff';
-
-/* eslint max-nested-callbacks: [0] */
-
-/**
- * Makes a promise-returning method retryable according to the specified backoff
- * pattern
- * @param {Object} options
- * @param {boolean} options.backoff
- * @param {number} options.delay
- * @param {number} options.initialDelay
- * @param {number} options.maxAttempts
- * @param {number} options.maxDelay
- *
- * @returns {Function}
- */
-export default function retry(...params) {
-  let options = params[0] || {};
-
-  options = {...options};
-  defaults(options, {
-    backoff: true,
-    delay: 1,
-    maxAttempts: 3,
-  });
-
-  let strategyOptions;
-
-  if (options.backoff) {
-    strategyOptions = {
-      initialDelay: options.delay,
-      maxDelay: options.maxDelay,
-    };
-  } else {
-    strategyOptions = {
-      initialDelay: 1,
-      maxDelay: 1,
-    };
-  }
-
-  if (params.length === 3) {
-    return Reflect.apply(retryDecorator, null, params);
-  }
-
-  return retryDecorator;
-
-  /**
-   * @param {Object} target
-   * @param {string} prop
-   * @param {Object} descriptor
-   * @private
-   * @returns {Object}
-   */
-  function retryDecorator(target, prop, descriptor) {
-    descriptor.value = wrap(descriptor.value, function retryExecutor(fn, ...args) {
-      const emitter = new EventEmitter();
-      const promise = new Promise((resolve, reject) => {
-        // backoff.call is not Function.prototype.call; it's an unfortunate naming
-        // collision.
-        /* eslint prefer-reflect: [0] */
-        const call = backoff.call(
-          (cb) => {
-            /* eslint no-invalid-this: [0] */
-            const innerPromise = Reflect.apply(fn, this, args);
-
-            if (isFunction(innerPromise.on)) {
-              innerPromise.on('progress', emitter.emit.bind(emitter, 'progress'));
-              innerPromise.on('upload-progress', emitter.emit.bind(emitter, 'upload-progress'));
-              innerPromise.on('download-progress', emitter.emit.bind(emitter, 'download-progress'));
-            }
-
-            return innerPromise
-              .then((res) => {
-                cb(null, res);
-              })
-              .catch((reason) => {
-                if (!reason) {
-                  reason = new Error('retryable method failed without providing an error object');
-                }
-                cb(reason);
-              });
-          },
-          (err, res) => {
-            if (err) {
-              return reject(err);
-            }
-
-            return resolve(res);
-          }
-        );
-
-        call.setStrategy(new backoff.ExponentialStrategy(strategyOptions));
-        if (options.maxAttempts) {
-          call.failAfter(options.maxAttempts - 1);
-        }
-
-        call.start();
-      });
-
-      promise.on = function on(key, callback) {
-        emitter.on(key, callback);
-
-        return promise;
-      };
-
-      return promise;
-    });
-
-    // This *should* make decorators compatible with AmpersandState class
-    // definitions
-    if (typeof target === 'object' && !target.prototype) {
-      target[prop] = descriptor.value;
-    }
-
-    return descriptor;
-  }
-}
+/*!
+ * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
+ */
+
+import {EventEmitter} from 'events';
+
+import {defaults, isFunction, wrap} from 'lodash';
+import backoff from 'backoff';
+
+/* eslint max-nested-callbacks: [0] */
+
+/**
+ * Makes a promise-returning method retryable according to the specified backoff
+ * pattern
+ * @param {Object} options
+ * @param {boolean} options.backoff
+ * @param {number} options.delay
+ * @param {number} options.initialDelay
+ * @param {number} options.maxAttempts
+ * @param {number} options.maxDelay
+ *
+ * @returns {Function}
+ */
+export default function retry(...params) {
+  let options = params[0] || {};
+
+  options = {...options};
+  defaults(options, {
+    backoff: true,
+    delay: 1,
+    maxAttempts: 3,
+  });
+
+  let strategyOptions;
+
+  if (options.backoff) {
+    strategyOptions = {
+      initialDelay: options.delay,
+      maxDelay: options.maxDelay,
+    };
+  } else {
+    strategyOptions = {
+      initialDelay: 1,
+      maxDelay: 1,
+    };
+  }
+
+  if (params.length === 3) {
+    return Reflect.apply(retryDecorator, null, params);
+  }
+
+  return retryDecorator;
+
+  /**
+   * @param {Object} target
+   * @param {string} prop
+   * @param {Object} descriptor
+   * @private
+   * @returns {Object}
+   */
+  function retryDecorator(target, prop, descriptor) {
+    descriptor.value = wrap(descriptor.value, function retryExecutor(fn, ...args) {
+      const emitter = new EventEmitter();
+      const promise = new Promise((resolve, reject) => {
+        // backoff.call is not Function.prototype.call; it's an unfortunate naming
+        // collision.
+        /* eslint prefer-reflect: [0] */
+        const call = backoff.call(
+          (cb) => {
+            /* eslint no-invalid-this: [0] */
+            const innerPromise = Reflect.apply(fn, this, args);
+
+            if (isFunction(innerPromise.on)) {
+              innerPromise.on('progress', emitter.emit.bind(emitter, 'progress'));
+              innerPromise.on('upload-progress', emitter.emit.bind(emitter, 'upload-progress'));
+              innerPromise.on('download-progress', emitter.emit.bind(emitter, 'download-progress'));
+            }
+
+            return innerPromise
+              .then((res) => {
+                cb(null, res);
+              })
+              .catch((reason) => {
+                if (!reason) {
+                  reason = new Error('retryable method failed without providing an error object');
+                }
+                cb(reason);
+              });
+          },
+          (err, res) => {
+            if (err) {
+              return reject(err);
+            }
+
+            return resolve(res);
+          }
+        );
+
+        call.setStrategy(new backoff.ExponentialStrategy(strategyOptions));
+        if (options.maxAttempts) {
+          call.failAfter(options.maxAttempts - 1);
+        }
+
+        call.start();
+      });
+
+      promise.on = function on(key, callback) {
+        emitter.on(key, callback);
+
+        return promise;
+      };
+
+      return promise;
+    });
+
+    // This *should* make decorators compatible with AmpersandState class
+    // definitions
+    if (typeof target === 'object' && !target.prototype) {
+      target[prop] = descriptor.value;
+    }
+
+    return descriptor;
+  }
+}

package/src/tap.js

@@ -1,25 +1,25 @@
-/*!
- * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
- */
-
-/**
- * Injects code into a promise chain without modifying the promise chain's result
- * @param {Function} fn
- * @returns {Promise}
- * @example
- * function f() {
- *   return Promise.resolve(5);
- * }
- *
- * f()
- *   .then(tap(() => 12))
- *   // => 5
- */
-export default function tap(fn) {
-  return (r) =>
-    new Promise((resolve) => {
-      resolve(fn(r));
-    })
-      .then(() => r)
-      .catch(() => r);
-}
+/*!
+ * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
+ */
+
+/**
+ * Injects code into a promise chain without modifying the promise chain's result
+ * @param {Function} fn
+ * @returns {Promise}
+ * @example
+ * function f() {
+ *   return Promise.resolve(5);
+ * }
+ *
+ * f()
+ *   .then(tap(() => 12))
+ *   // => 5
+ */
+export default function tap(fn) {
+  return (r) =>
+    new Promise((resolve) => {
+      resolve(fn(r));
+    })
+      .then(() => r)
+      .catch(() => r);
+}