@twilio/mcs-client 0.5.3 → 0.6.0-rc.1

package/builds/lib.js

@@ -19,9 +19,13 @@ CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+require('core-js/modules/es.promise.js');
 var _asyncToGenerator = require('@babel/runtime/helpers/asyncToGenerator');
 var _defineProperty = require('@babel/runtime/helpers/defineProperty');
-require('core-js/modules/es.promise.js');
+require('core-js/modules/es.array.iterator.js');
+require('core-js/modules/es.map.js');
+require('core-js/modules/web.dom-collections.iterator.js');
+require('core-js/modules/web.dom-collections.for-each.js');
 var _regeneratorRuntime = require('@babel/runtime/regenerator');
 require('core-js/modules/es.array.from.js');
 var log$2 = require('loglevel');
@@ -30,8 +34,6 @@ require('core-js/modules/es.array.reduce.js');
 require('core-js/modules/es.regexp.exec.js');
 require('core-js/modules/es.string.split.js');
 require('core-js/modules/es.object.assign.js');
-require('core-js/modules/es.array.iterator.js');
-require('core-js/modules/web.dom-collections.iterator.js');
 require('core-js/modules/web.url.js');
 var operationRetrier = require('@twilio/operation-retrier');
 var declarativeTypeValidator = require('@twilio/declarative-type-validator');
@@ -39,23 +41,23 @@ var declarativeTypeValidator = require('@twilio/declarative-type-validator');
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
 function _interopNamespace(e) {
-    if (e && e.__esModule) return e;
-    var n = Object.create(null);
-    if (e) {
-        Object.keys(e).forEach(function (k) {
-            if (k !== 'default') {
-                var d = Object.getOwnPropertyDescriptor(e, k);
-                Object.defineProperty(n, k, d.get ? d : {
-                    enumerable: true,
-                    get: function () {
-                        return e[k];
-                    }
-                });
-            }
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () {
+            return e[k];
+          }
         });
-    }
-    n['default'] = e;
-    return Object.freeze(n);
+      }
+    });
+  }
+  n['default'] = e;
+  return Object.freeze(n);
 }
 
 var _asyncToGenerator__default = /*#__PURE__*/_interopDefaultLegacy(_asyncToGenerator);
@@ -63,6 +65,66 @@ var _defineProperty__default = /*#__PURE__*/_interopDefaultLegacy(_definePropert
 var _regeneratorRuntime__default = /*#__PURE__*/_interopDefaultLegacy(_regeneratorRuntime);
 var log__namespace = /*#__PURE__*/_interopNamespace(log$2);
 
+/**
+ * Cancellable promise. Extends the functionality of the native Promise to include the cancel method.
+ *
+ * Example:
+ *
+ * ```ts
+ *
+ * const cancellableFetchPromise = new CancellablePromise(async (resolve, reject, onCancel) => {
+ *     const request = fetch("https://example.com/");
+ *
+ *     onCancel(() => request.cancel());
+ *
+ *     try {
+ *         const response = await request;
+ *         resolve(response);
+ *     } catch (err) {
+ *         reject(err);
+ *     }
+ * });
+ *
+ * cancellableFetchPromise.cancel();
+ * ```
+ */
+class CancellablePromise extends Promise {
+  /**
+   * Creates a new CancellablePromise.
+   * @param executor A callback used to initialize the promise. This callback is passed three arguments:
+   * a resolve callback used to resolve the promise with a value or the result of another promise,
+   * a reject callback used to reject the promise with a provided reason or error,
+   * and an onCancel callback used to define behavior of cancellation.
+   */
+  constructor(executor) {
+    var outerCancellationFunction;
+    var outerRejectPromise;
+    super((resolve, reject) => {
+      outerRejectPromise = reject;
+      return executor(resolve, reject, cancellationFunction => {
+        outerCancellationFunction = cancellationFunction;
+      });
+    });
+    this.cancel = outerCancellationFunction;
+    this.rejectPromise = outerRejectPromise;
+  }
+  /**
+   * Cancels the promise and invokes the cancellation callback if it was defined during instantiation. Cancellation will result in the promise being rejected.
+   */
+
+
+  cancel() {
+    if (this.onCancel) {
+      this.onCancel();
+    }
+
+    if (this.rejectPromise) {
+      this.rejectPromise(new Error("Promise was cancelled"));
+    }
+  }
+
+}
+
 /*! *****************************************************************************
 Copyright (c) Microsoft Corporation.
 
@@ -250,6 +312,7 @@ class Configuration {
  * @property {String} fileName - file name, if present, null otherwise
  * @property {MediaCategory} category - attachment category
  */
+
 class Media {
   constructor(config, network, data) {
     this.config = config;
@@ -302,79 +365,51 @@ class Media {
    *
    * It is reasonable to build your own refresh logic upon these two functions: as soon as URL returned
    * by getCachedContentUrl() returns 40x status you should call getContentUrl() to refresh it.
-   *
-   * @returns {Promise<string>}
    */
 
 
   getContentUrl() {
     var _this = this;
 
-    return _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee() {
-      var response;
-      return _regeneratorRuntime__default['default'].wrap(function _callee$(_context) {
-        while (1) {
-          switch (_context.prev = _context.next) {
-            case 0:
-              _context.next = 2;
-              return _this.network.get("".concat(_this.config.mediaUrl, "/").concat(_this.sid));
-
-            case 2:
-              response = _context.sent;
-
-              _this._update(response.body);
-
-              return _context.abrupt("return", Promise.resolve(_this.state.contentDirectUrl));
-
-            case 5:
-            case "end":
-              return _context.stop();
-          }
-        }
-      }, _callee);
-    }))();
-  }
-  /**
-   * Returns direct content URL to uploaded binary. This URL will expire after some time.
-   * This function does not support getting a new URL however. Once set it will remain the same.
-   * Use getContentUrl() to query a new one.
-   *
-   * It is reasonable to build your own refresh logic upon these two functions: as soon as URL returned
-   * by getCachedContentUrl() returns 40x status you should call getContentUrl() to refresh it.
-   *
-   * @returns {Promise<string>}
-   */
-
-
-  getCachedContentUrl() {
-    var _this2 = this;
-
-    return _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee2() {
-      return _regeneratorRuntime__default['default'].wrap(function _callee2$(_context2) {
-        while (1) {
-          switch (_context2.prev = _context2.next) {
-            case 0:
-              if (!_this2.state.contentDirectUrl) {
-                _context2.next = 2;
+    return new CancellablePromise( /*#__PURE__*/function () {
+      var _ref = _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee(resolve, reject, onCancel) {
+        var request, response;
+        return _regeneratorRuntime__default['default'].wrap(function _callee$(_context) {
+          while (1) {
+            switch (_context.prev = _context.next) {
+              case 0:
+                request = _this.network.get("".concat(_this.config.mediaUrl, "/").concat(_this.sid));
+                onCancel(() => request.cancel());
+                _context.prev = 2;
+                _context.next = 5;
+                return request;
+
+              case 5:
+                response = _context.sent;
+
+                _this._update(response.body);
+
+                resolve(_this.state.contentDirectUrl);
+                _context.next = 13;
                 break;
-              }
 
-              return _context2.abrupt("return", Promise.resolve(_this2.state.contentDirectUrl));
+              case 10:
+                _context.prev = 10;
+                _context.t0 = _context["catch"](2);
+                reject(_context.t0);
 
-            case 2:
-              _context2.next = 4;
-              return _this2.getContentUrl();
-
-            case 4:
-              return _context2.abrupt("return", _context2.sent);
-
-            case 5:
-            case "end":
-              return _context2.stop();
+              case 13:
+              case "end":
+                return _context.stop();
+            }
           }
-        }
-      }, _callee2);
-    }))();
+        }, _callee, null, [[2, 10]]);
+      }));
+
+      return function (_x, _x2, _x3) {
+        return _ref.apply(this, arguments);
+      };
+    }());
   }
 
   _update(data) {
@@ -446,64 +481,56 @@ function extractBody(xhr) {
 
 class Transport {
   static request(method, url, headers, body) {
-    return _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee() {
-      return _regeneratorRuntime__default['default'].wrap(function _callee$(_context) {
-        while (1) {
-          switch (_context.prev = _context.next) {
-            case 0:
-              return _context.abrupt("return", new Promise((resolve, reject) => {
-                var xhr = new XHR();
-                xhr.open(method, url, true);
-
-                xhr.onreadystatechange = function onreadystatechange() {
-                  if (xhr.readyState !== 4) {
-                    return;
-                  }
-
-                  var headers = parseResponseHeaders(xhr.getAllResponseHeaders());
-                  var body = extractBody(xhr);
-
-                  if (200 <= xhr.status && xhr.status < 300) {
-                    resolve({
-                      status: xhr.status,
-                      headers,
-                      body
-                    });
-                  } else {
-                    var _xhr$statusText;
-
-                    var status = (_xhr$statusText = xhr.statusText) !== null && _xhr$statusText !== void 0 ? _xhr$statusText : "NONE";
-                    var bodyRepresentation;
-
-                    if (typeof body === "string") {
-                      bodyRepresentation = body && body.split("\n", 2).length === 1 ? body : "";
-                    } else {
-                      bodyRepresentation = JSON.stringify(body);
-                    }
-
-                    var message = "".concat(xhr.status, ": [").concat(status, "] ").concat(bodyRepresentation);
-                    reject(new TransportError(message, xhr.status, body, status, headers));
-                  }
-                };
+    return new CancellablePromise((resolve, reject, onCancel) => {
+      var xhr = new XHR();
+      var isCancelled = false;
+      onCancel(() => {
+        xhr.abort();
+        isCancelled = true;
+      });
+      xhr.open(method, url, true);
+
+      xhr.onreadystatechange = function onreadystatechange() {
+        if (xhr.readyState !== 4 || isCancelled) {
+          return;
+        }
 
-                for (var headerName in headers) {
-                  xhr.setRequestHeader(headerName, headers[headerName]);
+        var headers = parseResponseHeaders(xhr.getAllResponseHeaders());
+        var body = extractBody(xhr);
+
+        if (200 <= xhr.status && xhr.status < 300) {
+          resolve({
+            status: xhr.status,
+            headers,
+            body
+          });
+        } else {
+          var _xhr$statusText;
+
+          var status = (_xhr$statusText = xhr.statusText) !== null && _xhr$statusText !== void 0 ? _xhr$statusText : "NONE";
+          var bodyRepresentation;
+
+          if (typeof body === "string") {
+            bodyRepresentation = body && body.split("\n", 2).length === 1 ? body : "";
+          } else {
+            bodyRepresentation = JSON.stringify(body);
+          }
 
-                  if (headerName === "Content-Type" && headers[headerName] === "application/json") {
-                    body = JSON.stringify(body);
-                  }
-                }
+          var message = "".concat(xhr.status, ": [").concat(status, "] ").concat(bodyRepresentation);
+          reject(new TransportError(message, xhr.status, body, status, headers));
+        }
+      };
 
-                xhr.send(body);
-              }));
+      for (var headerName in headers) {
+        xhr.setRequestHeader(headerName, headers[headerName]);
 
-            case 1:
-            case "end":
-              return _context.stop();
-          }
+        if (headerName === "Content-Type" && headers[headerName] === "application/json") {
+          body = JSON.stringify(body);
         }
-      }, _callee);
-    }))();
+      }
+
+      xhr.send(body);
+    });
   }
   /**
    * Make a GET request by given URL
@@ -511,20 +538,7 @@ class Transport {
 
 
   get(url, headers) {
-    return _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee2() {
-      return _regeneratorRuntime__default['default'].wrap(function _callee2$(_context2) {
-        while (1) {
-          switch (_context2.prev = _context2.next) {
-            case 0:
-              return _context2.abrupt("return", Transport.request("GET", url, headers));
-
-            case 1:
-            case "end":
-              return _context2.stop();
-          }
-        }
-      }, _callee2);
-    }))();
+    return Transport.request("GET", url, headers);
   }
   /**
    * Make a POST request by given URL
@@ -532,20 +546,7 @@ class Transport {
 
 
   post(url, headers, body) {
-    return _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee3() {
-      return _regeneratorRuntime__default['default'].wrap(function _callee3$(_context3) {
-        while (1) {
-          switch (_context3.prev = _context3.next) {
-            case 0:
-              return _context3.abrupt("return", Transport.request("POST", url, headers, body));
-
-            case 1:
-            case "end":
-              return _context3.stop();
-          }
-        }
-      }, _callee3);
-    }))();
+    return Transport.request("POST", url, headers, body);
   }
 
 }
@@ -571,19 +572,25 @@ class Network {
   executeWithRetry(request, retryWhenThrottled) {
     var _this = this;
 
-    return _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee2() {
-      return _regeneratorRuntime__default['default'].wrap(function _callee2$(_context2) {
-        while (1) {
-          switch (_context2.prev = _context2.next) {
-            case 0:
-              return _context2.abrupt("return", new Promise((resolve, reject) => {
-                var codesToRetryOn = [502, 503, 504];
+    return new CancellablePromise( /*#__PURE__*/function () {
+      var _ref2 = _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee2(resolve, reject, onCancel) {
+        var retrier, codesToRetryOn;
+        return _regeneratorRuntime__default['default'].wrap(function _callee2$(_context2) {
+          while (1) {
+            switch (_context2.prev = _context2.next) {
+              case 0:
+                retrier = new operationRetrier.Retrier(_this.backoffConfig());
+                onCancel(() => {
+                  request.cancel();
+                  retrier.removeAllListeners();
+                  retrier.cancel();
+                });
+                codesToRetryOn = [502, 503, 504];
 
                 if (retryWhenThrottled) {
                   codesToRetryOn.push(429);
                 }
 
-                var retrier = new operationRetrier.Retrier(_this.backoffConfig());
                 retrier.on("attempt", /*#__PURE__*/_asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee() {
                   var result;
                   return _regeneratorRuntime__default['default'].wrap(function _callee$(_context) {
@@ -629,124 +636,148 @@ class Network {
                 retrier.on("cancelled", err => reject(err));
                 retrier.on("failed", err => reject(err));
                 retrier.start();
-              }));
 
-            case 1:
-            case "end":
-              return _context2.stop();
+              case 9:
+              case "end":
+                return _context2.stop();
+            }
           }
-        }
-      }, _callee2);
-    }))();
+        }, _callee2);
+      }));
+
+      return function (_x, _x2, _x3) {
+        return _ref2.apply(this, arguments);
+      };
+    }());
   }
 
   get(url) {
     var _this2 = this;
 
-    return _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee3() {
-      var headers, response;
-      return _regeneratorRuntime__default['default'].wrap(function _callee3$(_context3) {
-        while (1) {
-          switch (_context3.prev = _context3.next) {
-            case 0:
-              headers = {
-                "X-Twilio-Token": _this2.config.token
-              };
-              log$1.trace("sending GET request to ", url, " headers ", headers);
-              _context3.prev = 2;
-              _context3.next = 5;
-              return _this2.executeWithRetry(() => _this2.transport.get(url, headers), _this2.retryWhenThrottled());
-
-            case 5:
-              response = _context3.sent;
-              log$1.trace("response", response);
-              return _context3.abrupt("return", response);
-
-            case 10:
-              _context3.prev = 10;
-              _context3.t0 = _context3["catch"](2);
-              log$1.debug("get() error ".concat(_context3.t0));
-              throw _context3.t0;
-
-            case 14:
-            case "end":
-              return _context3.stop();
+    return new CancellablePromise( /*#__PURE__*/function () {
+      var _ref4 = _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee3(resolve, reject, onCancel) {
+        var headers, request, response;
+        return _regeneratorRuntime__default['default'].wrap(function _callee3$(_context3) {
+          while (1) {
+            switch (_context3.prev = _context3.next) {
+              case 0:
+                headers = {
+                  "X-Twilio-Token": _this2.config.token
+                };
+                request = _this2.executeWithRetry(() => _this2.transport.get(url, headers), _this2.retryWhenThrottled());
+                log$1.trace("sending GET request to ", url, " headers ", headers);
+                onCancel(() => request.cancel());
+                _context3.prev = 4;
+                _context3.next = 7;
+                return request;
+
+              case 7:
+                response = _context3.sent;
+                log$1.trace("response", response);
+                resolve(response);
+                _context3.next = 16;
+                break;
+
+              case 12:
+                _context3.prev = 12;
+                _context3.t0 = _context3["catch"](4);
+                log$1.debug("get() error ".concat(_context3.t0));
+                reject(_context3.t0);
+
+              case 16:
+              case "end":
+                return _context3.stop();
+            }
           }
-        }
-      }, _callee3, null, [[2, 10]]);
-    }))();
+        }, _callee3, null, [[4, 12]]);
+      }));
+
+      return function (_x4, _x5, _x6) {
+        return _ref4.apply(this, arguments);
+      };
+    }());
   }
 
   post(url, category, media, contentType, filename) {
     var _this3 = this;
 
-    return _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee4() {
-      var headers, fullUrl, response;
-      return _regeneratorRuntime__default['default'].wrap(function _callee4$(_context4) {
-        while (1) {
-          switch (_context4.prev = _context4.next) {
-            case 0:
-              headers = {
-                "X-Twilio-Token": _this3.config.token
-              };
-
-              if ((typeof FormData === "undefined" || !(media instanceof FormData)) && contentType) {
-                Object.assign(headers, {
-                  "Content-Type": contentType
-                });
-              }
+    var headers = {
+      "X-Twilio-Token": this.config.token
+    };
 
-              fullUrl = new URL(url);
+    if ((typeof FormData === "undefined" || !(media instanceof FormData)) && contentType) {
+      Object.assign(headers, {
+        "Content-Type": contentType
+      });
+    }
 
-              if (category) {
-                fullUrl.searchParams.append("Category", category);
-              }
+    var fullUrl = new URL(url);
 
-              if (filename) {
-                fullUrl.searchParams.append("Filename", filename);
-              }
+    if (category) {
+      fullUrl.searchParams.append("Category", category);
+    }
 
-              log$1.trace("sending POST request to ".concat(url, " with headers ").concat(headers));
-              _context4.prev = 6;
-              _context4.next = 9;
-              return _this3.transport.post(fullUrl.href, headers, media);
+    if (filename) {
+      fullUrl.searchParams.append("Filename", filename);
+    }
 
-            case 9:
-              response = _context4.sent;
-              _context4.next = 18;
-              break;
+    return new CancellablePromise( /*#__PURE__*/function () {
+      var _ref5 = _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee4(resolve, reject, onCancel) {
+        var request, response;
+        return _regeneratorRuntime__default['default'].wrap(function _callee4$(_context4) {
+          while (1) {
+            switch (_context4.prev = _context4.next) {
+              case 0:
+                request = _this3.transport.post(fullUrl.href, headers, media);
+                onCancel(() => request.cancel());
+                log$1.trace("sending POST request to ".concat(url, " with headers ").concat(headers));
+                _context4.prev = 3;
+                _context4.next = 6;
+                return request;
+
+              case 6:
+                response = _context4.sent;
+                _context4.next = 17;
+                break;
 
-            case 12:
-              _context4.prev = 12;
-              _context4.t0 = _context4["catch"](6);
+              case 9:
+                _context4.prev = 9;
+                _context4.t0 = _context4["catch"](3);
 
-              if (!(global["XMLHttpRequest"] === undefined && media instanceof FormData)) {
-                _context4.next = 16;
-                break;
-              }
+                if (!(global["XMLHttpRequest"] === undefined && media instanceof FormData)) {
+                  _context4.next = 14;
+                  break;
+                }
 
-              throw new TypeError("Posting FormData supported only with browser engine's FormData");
+                reject(new TypeError("Posting FormData supported only with browser engine's FormData"));
+                return _context4.abrupt("return");
 
-            case 16:
-              log$1.debug("post() error ".concat(_context4.t0));
-              throw _context4.t0;
+              case 14:
+                log$1.debug("post() error ".concat(_context4.t0));
+                reject(_context4.t0);
+                return _context4.abrupt("return");
 
-            case 18:
-              log$1.trace("response", response);
-              return _context4.abrupt("return", response);
+              case 17:
+                log$1.trace("response", response);
+                resolve(response);
 
-            case 20:
-            case "end":
-              return _context4.stop();
+              case 19:
+              case "end":
+                return _context4.stop();
+            }
           }
-        }
-      }, _callee4, null, [[6, 12]]);
-    }))();
+        }, _callee4, null, [[3, 9]]);
+      }));
+
+      return function (_x7, _x8, _x9) {
+        return _ref5.apply(this, arguments);
+      };
+    }());
   }
 
 }
 
-var version = "0.5.3";
+var version = "0.6.0-rc.1";
 
 var _class, _temp;
 var log = Logger.scope("");
@@ -799,66 +830,96 @@ exports['default'] = (_temp = _class = class Client {
   /**
    * Gets media from media service
    * @param {String} sid - Media's SID
-   * @returns {Promise<Media>}
    */
 
 
   get(sid) {
     var _this = this;
 
-    return _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee() {
-      var response;
-      return _regeneratorRuntime__default['default'].wrap(function _callee$(_context) {
-        while (1) {
-          switch (_context.prev = _context.next) {
-            case 0:
-              _context.next = 2;
-              return _this.network.get("".concat(_this.config.mediaUrl, "/").concat(sid));
-
-            case 2:
-              response = _context.sent;
-              return _context.abrupt("return", new Media(_this.config, _this.network, response.body));
-
-            case 4:
-            case "end":
-              return _context.stop();
+    return new CancellablePromise( /*#__PURE__*/function () {
+      var _ref = _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee(resolve, reject, onCancel) {
+        var request, response;
+        return _regeneratorRuntime__default['default'].wrap(function _callee$(_context) {
+          while (1) {
+            switch (_context.prev = _context.next) {
+              case 0:
+                request = _this.network.get("".concat(_this.config.mediaUrl, "/").concat(sid));
+                onCancel(() => request.cancel());
+                _context.prev = 2;
+                _context.next = 5;
+                return request;
+
+              case 5:
+                response = _context.sent;
+                resolve(new Media(_this.config, _this.network, response.body));
+                _context.next = 12;
+                break;
+
+              case 9:
+                _context.prev = 9;
+                _context.t0 = _context["catch"](2);
+                reject(_context.t0);
+
+              case 12:
+              case "end":
+                return _context.stop();
+            }
           }
-        }
-      }, _callee);
-    }))();
+        }, _callee, null, [[2, 9]]);
+      }));
+
+      return function (_x, _x2, _x3) {
+        return _ref.apply(this, arguments);
+      };
+    }());
   }
   /**
    * Posts raw content to media service
    * @param {String} contentType - content type of media
    * @param {String|Buffer|Blob} media - content to post
    * @param {MediaCategory|null} category - category for the media
-   * @returns {Promise<Media>}
    */
 
 
   post(contentType, media, category, filename) {
     var _this2 = this;
 
-    return _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee2() {
-      var response;
-      return _regeneratorRuntime__default['default'].wrap(function _callee2$(_context2) {
-        while (1) {
-          switch (_context2.prev = _context2.next) {
-            case 0:
-              _context2.next = 2;
-              return _this2.network.post(_this2.config.mediaUrl, category !== null && category !== void 0 ? category : "media", media, contentType, filename);
-
-            case 2:
-              response = _context2.sent;
-              return _context2.abrupt("return", new Media(_this2.config, _this2.network, response.body));
-
-            case 4:
-            case "end":
-              return _context2.stop();
+    return new CancellablePromise( /*#__PURE__*/function () {
+      var _ref2 = _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee2(resolve, reject, onCancel) {
+        var request, response;
+        return _regeneratorRuntime__default['default'].wrap(function _callee2$(_context2) {
+          while (1) {
+            switch (_context2.prev = _context2.next) {
+              case 0:
+                request = _this2.network.post(_this2.config.mediaUrl, category !== null && category !== void 0 ? category : "media", media, contentType, filename);
+                onCancel(() => request.cancel());
+                _context2.prev = 2;
+                _context2.next = 5;
+                return request;
+
+              case 5:
+                response = _context2.sent;
+                resolve(new Media(_this2.config, _this2.network, response.body));
+                _context2.next = 12;
+                break;
+
+              case 9:
+                _context2.prev = 9;
+                _context2.t0 = _context2["catch"](2);
+                reject(_context2.t0);
+
+              case 12:
+              case "end":
+                return _context2.stop();
+            }
           }
-        }
-      }, _callee2);
-    }))();
+        }, _callee2, null, [[2, 9]]);
+      }));
+
+      return function (_x4, _x5, _x6) {
+        return _ref2.apply(this, arguments);
+      };
+    }());
   }
   /**
    * Posts FormData to media service. Can be used only with browser engine's FormData.
@@ -866,33 +927,48 @@ exports['default'] = (_temp = _class = class Client {
    * new TypeError("Posting FormData supported only with browser engine's FormData")
    * @param {FormData} formData - form data to post
    * @param {MediaCategory|null} category - category for the media
-   * @returns {Promise<Media>}
    */
 
 
   postFormData(formData, category) {
     var _this3 = this;
 
-    return _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee3() {
-      var response;
-      return _regeneratorRuntime__default['default'].wrap(function _callee3$(_context3) {
-        while (1) {
-          switch (_context3.prev = _context3.next) {
-            case 0:
-              _context3.next = 2;
-              return _this3.network.post(_this3.config.mediaUrl, category !== null && category !== void 0 ? category : "media", formData);
-
-            case 2:
-              response = _context3.sent;
-              return _context3.abrupt("return", new Media(_this3.config, _this3.network, response.body));
-
-            case 4:
-            case "end":
-              return _context3.stop();
+    return new CancellablePromise( /*#__PURE__*/function () {
+      var _ref3 = _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee3(resolve, reject, onCancel) {
+        var request, response;
+        return _regeneratorRuntime__default['default'].wrap(function _callee3$(_context3) {
+          while (1) {
+            switch (_context3.prev = _context3.next) {
+              case 0:
+                request = _this3.network.post(_this3.config.mediaUrl, category !== null && category !== void 0 ? category : "media", formData);
+                onCancel(() => request.cancel());
+                _context3.prev = 2;
+                _context3.next = 5;
+                return request;
+
+              case 5:
+                response = _context3.sent;
+                resolve(new Media(_this3.config, _this3.network, response.body));
+                _context3.next = 12;
+                break;
+
+              case 9:
+                _context3.prev = 9;
+                _context3.t0 = _context3["catch"](2);
+                reject(_context3.t0);
+
+              case 12:
+              case "end":
+                return _context3.stop();
+            }
           }
-        }
-      }, _callee3);
-    }))();
+        }, _callee3, null, [[2, 9]]);
+      }));
+
+      return function (_x7, _x8, _x9) {
+        return _ref3.apply(this, arguments);
+      };
+    }());
   }
   /**
    * Retrieve information about multiple media SIDs at the same time.
@@ -903,48 +979,128 @@ exports['default'] = (_temp = _class = class Client {
   mediaSetGet(mediaSids) {
     var _this4 = this;
 
-    return _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee4() {
-      var query, response;
-      return _regeneratorRuntime__default['default'].wrap(function _callee4$(_context4) {
-        while (1) {
-          switch (_context4.prev = _context4.next) {
-            case 0:
-              query = {
-                command: "get",
-                list: mediaSids.map(sid => ({
-                  media_sid: sid
-                }))
-              };
-              _context4.next = 3;
-              return _this4.network.post("".concat(_this4.config.mediaSetUrl), null, query, "application/json");
-
-            case 3:
-              response = _context4.sent;
-              return _context4.abrupt("return", response.body.map(item => {
-                if (item.code !== 200) {
-                  throw new Error("Failed to obtain detailed information about Media items (failed SID ".concat(item.media_record.sid, ")"));
-                }
+    return new CancellablePromise( /*#__PURE__*/function () {
+      var _ref4 = _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee4(resolve, reject, onCancel) {
+        var query, request, response, media;
+        return _regeneratorRuntime__default['default'].wrap(function _callee4$(_context4) {
+          while (1) {
+            switch (_context4.prev = _context4.next) {
+              case 0:
+                query = {
+                  command: "get",
+                  list: mediaSids.map(sid => ({
+                    media_sid: sid
+                  }))
+                };
+                request = _this4.network.post("".concat(_this4.config.mediaSetUrl), null, query, "application/json");
+                onCancel(() => request.cancel());
+                _context4.prev = 3;
+                _context4.next = 6;
+                return request;
+
+              case 6:
+                response = _context4.sent;
+                media = response.body.map(item => {
+                  if (item.code !== 200) {
+                    reject("Failed to obtain detailed information about Media items (failed SID ".concat(item.media_record.sid, ")"));
+                    return;
+                  }
+
+                  return new Media(_this4.config, _this4.network, item.media_record);
+                });
+                resolve(media);
+                _context4.next = 14;
+                break;
 
-                return new Media(_this4.config, _this4.network, item.media_record);
-              }));
+              case 11:
+                _context4.prev = 11;
+                _context4.t0 = _context4["catch"](3);
+                reject(_context4.t0);
 
-            case 5:
-            case "end":
-              return _context4.stop();
+              case 14:
+              case "end":
+                return _context4.stop();
+            }
           }
-        }
-      }, _callee4);
-    }))();
+        }, _callee4, null, [[3, 11]]);
+      }));
+
+      return function (_x10, _x11, _x12) {
+        return _ref4.apply(this, arguments);
+      };
+    }());
+  }
+  /**
+   * Retrieve temporary URLs for a set of media SIDs.
+   * @param mediaSids array of the media SIDs to get URLs from.
+   */
+
+
+  mediaSetGetContentUrls(mediaSids) {
+    var _this5 = this;
+
+    return new CancellablePromise( /*#__PURE__*/function () {
+      var _ref5 = _asyncToGenerator__default['default']( /*#__PURE__*/_regeneratorRuntime__default['default'].mark(function _callee5(resolve, reject, onCancel) {
+        var query, request, response, urls;
+        return _regeneratorRuntime__default['default'].wrap(function _callee5$(_context5) {
+          while (1) {
+            switch (_context5.prev = _context5.next) {
+              case 0:
+                query = {
+                  command: "get",
+                  list: mediaSids.map(sid => ({
+                    media_sid: sid
+                  }))
+                };
+                request = _this5.network.post("".concat(_this5.config.mediaSetUrl), null, query, "application/json");
+                onCancel(() => request.cancel());
+                _context5.prev = 3;
+                _context5.next = 6;
+                return request;
+
+              case 6:
+                response = _context5.sent;
+                urls = new Map();
+                response.body.forEach(item => {
+                  if (item.code !== 200) {
+                    reject("Failed to obtain detailed information about Media items (failed SID ".concat(item.media_record.sid, ")"));
+                    return;
+                  }
+
+                  urls.set(item.media_record.sid, item.media_record.links.content_direct_temporary);
+                });
+                resolve(urls);
+                _context5.next = 15;
+                break;
+
+              case 12:
+                _context5.prev = 12;
+                _context5.t0 = _context5["catch"](3);
+                reject(_context5.t0);
+
+              case 15:
+              case "end":
+                return _context5.stop();
+            }
+          }
+        }, _callee5, null, [[3, 12]]);
+      }));
+
+      return function (_x13, _x14, _x15) {
+        return _ref5.apply(this, arguments);
+      };
+    }());
   }
 
 }, _defineProperty__default['default'](_class, "version", version), _temp);
 
 __decorate([declarativeTypeValidator.validateTypes(declarativeTypeValidator.nonEmptyString), __metadata("design:type", Function), __metadata("design:paramtypes", [String]), __metadata("design:returntype", void 0)], exports['default'].prototype, "updateToken", null);
 
-__decorate([declarativeTypeValidator.validateTypesAsync(declarativeTypeValidator.nonEmptyString), __metadata("design:type", Function), __metadata("design:paramtypes", [String]), __metadata("design:returntype", Promise)], exports['default'].prototype, "get", null);
+__decorate([declarativeTypeValidator.validateTypesAsync(declarativeTypeValidator.nonEmptyString), __metadata("design:type", Function), __metadata("design:paramtypes", [String]), __metadata("design:returntype", CancellablePromise)], exports['default'].prototype, "get", null);
 
 exports['default'] = __decorate([declarativeTypeValidator.validateConstructorTypes(declarativeTypeValidator.nonEmptyString, declarativeTypeValidator.nonEmptyString, [declarativeTypeValidator.nonEmptyString, declarativeTypeValidator.literal(null)], [declarativeTypeValidator.pureObject, "undefined"]), __metadata("design:paramtypes", [String, String, Object, Object])], exports['default']); // Proper renames should happen in index.ts,
 
+exports.CancellablePromise = CancellablePromise;
 exports.Client = exports['default'];
 exports.McsClient = exports['default'];
 exports.McsMedia = Media;