@ntlab/ntjs-assets 2.0.2 → 2.0.3

package/assets/js/socket.io/socket.io.js

@@ -1,6 +1,6 @@
 /*!
- * Socket.IO v4.5.0
- * (c) 2014-2022 Guillermo Rauch
+ * Socket.IO v4.7.0
+ * (c) 2014-2023 Guillermo Rauch
  * Released under the MIT License.
  */
 (function (global, factory) {
@@ -12,17 +12,11 @@
   function _typeof(obj) {
     "@babel/helpers - typeof";
 
-    if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") {
-      _typeof = function (obj) {
-        return typeof obj;
-      };
-    } else {
-      _typeof = function (obj) {
-        return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj;
-      };
-    }
-
-    return _typeof(obj);
+    return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) {
+      return typeof obj;
+    } : function (obj) {
+      return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj;
+    }, _typeof(obj);
   }
 
   function _classCallCheck(instance, Constructor) {
@@ -44,11 +38,14 @@
   function _createClass(Constructor, protoProps, staticProps) {
     if (protoProps) _defineProperties(Constructor.prototype, protoProps);
     if (staticProps) _defineProperties(Constructor, staticProps);
+    Object.defineProperty(Constructor, "prototype", {
+      writable: false
+    });
     return Constructor;
   }
 
   function _extends() {
-    _extends = Object.assign || function (target) {
+    _extends = Object.assign ? Object.assign.bind() : function (target) {
       for (var i = 1; i < arguments.length; i++) {
         var source = arguments[i];
 
@@ -61,7 +58,6 @@
 
       return target;
     };
-
     return _extends.apply(this, arguments);
   }
 
@@ -77,22 +73,24 @@
         configurable: true
       }
     });
+    Object.defineProperty(subClass, "prototype", {
+      writable: false
+    });
     if (superClass) _setPrototypeOf(subClass, superClass);
   }
 
   function _getPrototypeOf(o) {
-    _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) {
+    _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) {
       return o.__proto__ || Object.getPrototypeOf(o);
     };
     return _getPrototypeOf(o);
   }
 
   function _setPrototypeOf(o, p) {
-    _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) {
+    _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) {
       o.__proto__ = p;
       return o;
     };
-
     return _setPrototypeOf(o, p);
   }
 
@@ -111,7 +109,7 @@
 
   function _construct(Parent, args, Class) {
     if (_isNativeReflectConstruct()) {
-      _construct = Reflect.construct;
+      _construct = Reflect.construct.bind();
     } else {
       _construct = function _construct(Parent, args, Class) {
         var a = [null];
@@ -210,9 +208,9 @@
     return object;
   }
 
-  function _get(target, property, receiver) {
+  function _get() {
     if (typeof Reflect !== "undefined" && Reflect.get) {
-      _get = Reflect.get;
+      _get = Reflect.get.bind();
     } else {
       _get = function _get(target, property, receiver) {
         var base = _superPropBase(target, property);
@@ -221,14 +219,14 @@
         var desc = Object.getOwnPropertyDescriptor(base, property);
 
         if (desc.get) {
-          return desc.get.call(receiver);
+          return desc.get.call(arguments.length < 3 ? target : receiver);
         }
 
         return desc.value;
       };
     }
 
-    return _get(target, property, receiver || target);
+    return _get.apply(this, arguments);
   }
 
   function _unsupportedIterableToArray(o, minLen) {
@@ -357,17 +355,40 @@
 
     fileReader.onload = function () {
       var content = fileReader.result.split(",")[1];
-      callback("b" + content);
+      callback("b" + (content || ""));
     };
 
     return fileReader.readAsDataURL(data);
   };
 
-  /*
-   * base64-arraybuffer 1.0.1 <https://github.com/niklasvh/base64-arraybuffer>
-   * Copyright (c) 2022 Niklas von Hertzen <https://hertzen.com>
-   * Released under MIT License
-   */
+  function toArray(data) {
+    if (data instanceof Uint8Array) {
+      return data;
+    } else if (data instanceof ArrayBuffer) {
+      return new Uint8Array(data);
+    } else {
+      return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+    }
+  }
+
+  var TEXT_ENCODER;
+  function encodePacketToBinary(packet, callback) {
+    if (withNativeBlob$1 && packet.data instanceof Blob) {
+      return packet.data.arrayBuffer().then(toArray).then(callback);
+    } else if (withNativeArrayBuffer$2 && (packet.data instanceof ArrayBuffer || isView$1(packet.data))) {
+      return callback(toArray(packet.data));
+    }
+
+    encodePacket(packet, false, function (encoded) {
+      if (!TEXT_ENCODER) {
+        TEXT_ENCODER = new TextEncoder();
+      }
+
+      callback(TEXT_ENCODER.encode(encoded));
+    });
+  }
+
+  // imported from https://github.com/socketio/base64-arraybuffer
   var chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/'; // Use a lookup table to find the index.
 
   var lookup$1 = typeof Uint8Array === 'undefined' ? [] : new Uint8Array(256);
@@ -375,7 +396,6 @@
   for (var i$1 = 0; i$1 < chars.length; i$1++) {
     lookup$1[chars.charCodeAt(i$1)] = i$1;
   }
-
   var decode$1 = function decode(base64) {
     var bufferLength = base64.length * 0.75,
         len = base64.length,
@@ -411,7 +431,6 @@
   };
 
   var withNativeArrayBuffer$1 = typeof ArrayBuffer === "function";
-
   var decodePacket = function decodePacket(encodedPacket, binaryType) {
     if (typeof encodedPacket !== "string") {
       return {
@@ -458,12 +477,24 @@
   var mapBinary = function mapBinary(data, binaryType) {
     switch (binaryType) {
       case "blob":
-        return data instanceof ArrayBuffer ? new Blob([data]) : data;
+        if (data instanceof Blob) {
+          // from WebSocket + binaryType "blob"
+          return data;
+        } else {
+          // from HTTP long-polling or WebTransport
+          return new Blob([data]);
+        }
 
       case "arraybuffer":
       default:
-        return data;
-      // assuming the data is already an ArrayBuffer
+        if (data instanceof ArrayBuffer) {
+          // from HTTP long-polling (base64) or WebSocket + binaryType "arraybuffer"
+          return data;
+        } else {
+          // from WebTransport (Uint8Array)
+          return data.buffer;
+        }
+
     }
   };
 
@@ -502,6 +533,18 @@
     return packets;
   };
 
+  var TEXT_DECODER;
+  function decodePacketFromBinary(data, isBinary, binaryType) {
+    if (!TEXT_DECODER) {
+      // lazily created for compatibility with old browser platforms
+      TEXT_DECODER = new TextDecoder();
+    } // 48 === "0".charCodeAt(0) (OPEN packet type)
+    // 54 === "6".charCodeAt(0) (NOOP packet type)
+
+
+    var isPlainBinary = isBinary || data[0] < 48 || data[0] > 54;
+    return decodePacket(isPlainBinary ? data : TEXT_DECODER.decode(data), binaryType);
+  }
   var protocol$1 = 4;
 
   /**
@@ -667,7 +710,7 @@
     return !!this.listeners(event).length;
   };
 
-  var globalThis = (function () {
+  var globalThisShim = function () {
     if (typeof self !== "undefined") {
       return self;
     } else if (typeof window !== "undefined") {
@@ -675,7 +718,7 @@
     } else {
       return Function("return this")();
     }
-  })();
+  }();
 
   function pick(obj) {
     for (var _len = arguments.length, attr = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
@@ -691,15 +734,15 @@
     }, {});
   } // Keep a reference to the real timeout functions so they can be used when overridden
 
-  var NATIVE_SET_TIMEOUT = setTimeout;
-  var NATIVE_CLEAR_TIMEOUT = clearTimeout;
+  var NATIVE_SET_TIMEOUT = globalThisShim.setTimeout;
+  var NATIVE_CLEAR_TIMEOUT = globalThisShim.clearTimeout;
   function installTimerFunctions(obj, opts) {
     if (opts.useNativeTimers) {
-      obj.setTimeoutFn = NATIVE_SET_TIMEOUT.bind(globalThis);
-      obj.clearTimeoutFn = NATIVE_CLEAR_TIMEOUT.bind(globalThis);
+      obj.setTimeoutFn = NATIVE_SET_TIMEOUT.bind(globalThisShim);
+      obj.clearTimeoutFn = NATIVE_CLEAR_TIMEOUT.bind(globalThisShim);
     } else {
-      obj.setTimeoutFn = setTimeout.bind(globalThis);
-      obj.clearTimeoutFn = clearTimeout.bind(globalThis);
+      obj.setTimeoutFn = globalThisShim.setTimeout.bind(globalThisShim);
+      obj.clearTimeoutFn = globalThisShim.clearTimeout.bind(globalThisShim);
     }
   } // base64 encoded buffers are about 33% bigger (https://en.wikipedia.org/wiki/Base64)
 
@@ -736,6 +779,46 @@
     return length;
   }
 
+  // imported from https://github.com/galkn/querystring
+
+  /**
+   * Compiles a querystring
+   * Returns string representation of the object
+   *
+   * @param {Object}
+   * @api private
+   */
+  function encode$1(obj) {
+    var str = '';
+
+    for (var i in obj) {
+      if (obj.hasOwnProperty(i)) {
+        if (str.length) str += '&';
+        str += encodeURIComponent(i) + '=' + encodeURIComponent(obj[i]);
+      }
+    }
+
+    return str;
+  }
+  /**
+   * Parses a simple querystring into an object
+   *
+   * @param {String} qs
+   * @api private
+   */
+
+  function decode(qs) {
+    var qry = {};
+    var pairs = qs.split('&');
+
+    for (var i = 0, l = pairs.length; i < l; i++) {
+      var pair = pairs[i].split('=');
+      qry[decodeURIComponent(pair[0])] = decodeURIComponent(pair[1]);
+    }
+
+    return qry;
+  }
+
   var TransportError = /*#__PURE__*/function (_Error) {
     _inherits(TransportError, _Error);
 
@@ -753,7 +836,7 @@
       return _this;
     }
 
-    return TransportError;
+    return _createClass(TransportError);
   }( /*#__PURE__*/_wrapNativeSuper(Error));
 
   var Transport = /*#__PURE__*/function (_Emitter) {
@@ -764,8 +847,8 @@
     /**
      * Transport abstract constructor.
      *
-     * @param {Object} options.
-     * @api private
+     * @param {Object} opts - options
+     * @protected
      */
     function Transport(opts) {
       var _this2;
@@ -777,7 +860,6 @@
       installTimerFunctions(_assertThisInitialized(_this2), opts);
       _this2.opts = opts;
       _this2.query = opts.query;
-      _this2.readyState = "";
       _this2.socket = opts.socket;
       return _this2;
     }
@@ -788,7 +870,7 @@
      * @param description
      * @param context - the error context
      * @return {Transport} for chaining
-     * @api protected
+     * @protected
      */
 
 
@@ -801,30 +883,23 @@
       }
       /**
        * Opens the transport.
-       *
-       * @api public
        */
 
     }, {
       key: "open",
       value: function open() {
-        if ("closed" === this.readyState || "" === this.readyState) {
-          this.readyState = "opening";
-          this.doOpen();
-        }
-
+        this.readyState = "opening";
+        this.doOpen();
         return this;
       }
       /**
        * Closes the transport.
-       *
-       * @api public
        */
 
     }, {
       key: "close",
       value: function close() {
-        if ("opening" === this.readyState || "open" === this.readyState) {
+        if (this.readyState === "opening" || this.readyState === "open") {
           this.doClose();
           this.onClose();
         }
@@ -835,20 +910,19 @@
        * Sends multiple packets.
        *
        * @param {Array} packets
-       * @api public
        */
 
     }, {
       key: "send",
       value: function send(packets) {
-        if ("open" === this.readyState) {
+        if (this.readyState === "open") {
           this.write(packets);
         }
       }
       /**
        * Called upon open
        *
-       * @api protected
+       * @protected
        */
 
     }, {
@@ -863,7 +937,7 @@
        * Called with data.
        *
        * @param {String} data
-       * @api protected
+       * @protected
        */
 
     }, {
@@ -875,7 +949,7 @@
       /**
        * Called with a decoded packet.
        *
-       * @api protected
+       * @protected
        */
 
     }, {
@@ -886,7 +960,7 @@
       /**
        * Called upon close.
        *
-       * @api protected
+       * @protected
        */
 
     }, {
@@ -896,6 +970,42 @@
 
         _get(_getPrototypeOf(Transport.prototype), "emitReserved", this).call(this, "close", details);
       }
+      /**
+       * Pauses the transport, in order not to lose packets during an upgrade.
+       *
+       * @param onPause
+       */
+
+    }, {
+      key: "pause",
+      value: function pause(onPause) {}
+    }, {
+      key: "createUri",
+      value: function createUri(schema) {
+        var query = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+        return schema + "://" + this._hostname() + this._port() + this.opts.path + this._query(query);
+      }
+    }, {
+      key: "_hostname",
+      value: function _hostname() {
+        var hostname = this.opts.hostname;
+        return hostname.indexOf(":") === -1 ? hostname : "[" + hostname + "]";
+      }
+    }, {
+      key: "_port",
+      value: function _port() {
+        if (this.opts.port && (this.opts.secure && Number(this.opts.port !== 443) || !this.opts.secure && Number(this.opts.port) !== 80)) {
+          return ":" + this.opts.port;
+        } else {
+          return "";
+        }
+      }
+    }, {
+      key: "_query",
+      value: function _query(query) {
+        var encodedQuery = encode$1(query);
+        return encodedQuery.length ? "?" + encodedQuery : "";
+      }
     }]);
 
     return Transport;
@@ -917,7 +1027,7 @@
    * @api public
    */
 
-  function encode$1(num) {
+  function encode(num) {
     var encoded = '';
 
     do {
@@ -935,9 +1045,9 @@
    */
 
   function yeast() {
-    var now = encode$1(+new Date());
+    var now = encode(+new Date());
     if (now !== prev) return seed = 0, prev = now;
-    return now + '.' + encode$1(seed++);
+    return now + '.' + encode(seed++);
   } //
   // Map each character to its index.
   //
@@ -946,46 +1056,6 @@
     map[alphabet[i]] = i;
   }
 
-  // imported from https://github.com/galkn/querystring
-
-  /**
-   * Compiles a querystring
-   * Returns string representation of the object
-   *
-   * @param {Object}
-   * @api private
-   */
-  function encode(obj) {
-    var str = '';
-
-    for (var i in obj) {
-      if (obj.hasOwnProperty(i)) {
-        if (str.length) str += '&';
-        str += encodeURIComponent(i) + '=' + encodeURIComponent(obj[i]);
-      }
-    }
-
-    return str;
-  }
-  /**
-   * Parses a simple querystring into an object
-   *
-   * @param {String} qs
-   * @api private
-   */
-
-  function decode(qs) {
-    var qry = {};
-    var pairs = qs.split('&');
-
-    for (var i = 0, l = pairs.length; i < l; i++) {
-      var pair = pairs[i].split('=');
-      qry[decodeURIComponent(pair[0])] = decodeURIComponent(pair[1]);
-    }
-
-    return qry;
-  }
-
   // imported from https://github.com/component/has-cors
   var value = false;
 
@@ -998,7 +1068,7 @@
   var hasCORS = value;
 
   // browser shim for xmlhttprequest module
-  function XMLHttpRequest$1 (opts) {
+  function XHR(opts) {
     var xdomain = opts.xdomain; // XMLHttpRequest can be disabled on IE
 
     try {
@@ -1009,15 +1079,16 @@
 
     if (!xdomain) {
       try {
-        return new globalThis[["Active"].concat("Object").join("X")]("Microsoft.XMLHTTP");
+        return new globalThisShim[["Active"].concat("Object").join("X")]("Microsoft.XMLHTTP");
       } catch (e) {}
     }
   }
+  function createCookieJar() {}
 
   function empty() {}
 
   var hasXHR2 = function () {
-    var xhr = new XMLHttpRequest$1({
+    var xhr = new XHR({
       xdomain: false
     });
     return null != xhr.responseType;
@@ -1032,7 +1103,7 @@
      * XHR Polling constructor.
      *
      * @param {Object} opts
-     * @api public
+     * @package
      */
     function Polling(opts) {
       var _this;
@@ -1051,7 +1122,6 @@
         }
 
         _this.xd = typeof location !== "undefined" && opts.hostname !== location.hostname || port !== opts.port;
-        _this.xs = opts.secure !== isSSL;
       }
       /**
        * XHR supports binary
@@ -1060,12 +1130,13 @@
 
       var forceBase64 = opts && opts.forceBase64;
       _this.supportsBinary = hasXHR2 && !forceBase64;
+
+      if (_this.opts.withCredentials) {
+        _this.cookieJar = createCookieJar();
+      }
+
       return _this;
     }
-    /**
-     * Transport name.
-     */
-
 
     _createClass(Polling, [{
       key: "name",
@@ -1076,7 +1147,7 @@
        * Opens the socket (triggers polling). We write a PING message to determine
        * when the transport is open.
        *
-       * @api private
+       * @protected
        */
 
     }, {
@@ -1087,8 +1158,8 @@
       /**
        * Pauses polling.
        *
-       * @param {Function} callback upon buffers are flushed and transport is paused
-       * @api private
+       * @param {Function} onPause - callback upon buffers are flushed and transport is paused
+       * @package
        */
 
     }, {
@@ -1126,7 +1197,7 @@
       /**
        * Starts polling cycle.
        *
-       * @api public
+       * @private
        */
 
     }, {
@@ -1139,7 +1210,7 @@
       /**
        * Overloads onData to detect payloads.
        *
-       * @api private
+       * @protected
        */
 
     }, {
@@ -1182,7 +1253,7 @@
       /**
        * For polling, send a close packet.
        *
-       * @api private
+       * @protected
        */
 
     }, {
@@ -1207,9 +1278,8 @@
       /**
        * Writes a packets payload.
        *
-       * @param {Array} data packets
-       * @param {Function} drain callback
-       * @api private
+       * @param {Array} packets - data packets
+       * @protected
        */
 
     }, {
@@ -1229,15 +1299,14 @@
       /**
        * Generates uri for connection.
        *
-       * @api private
+       * @private
        */
 
     }, {
       key: "uri",
       value: function uri() {
-        var query = this.query || {};
         var schema = this.opts.secure ? "https" : "http";
-        var port = ""; // cache busting is forced
+        var query = this.query || {}; // cache busting is forced
 
         if (false !== this.opts.timestampRequests) {
           query[this.opts.timestampParam] = yeast();
@@ -1245,22 +1314,15 @@
 
         if (!this.supportsBinary && !query.sid) {
           query.b64 = 1;
-        } // avoid port if default for schema
-
-
-        if (this.opts.port && ("https" === schema && Number(this.opts.port) !== 443 || "http" === schema && Number(this.opts.port) !== 80)) {
-          port = ":" + this.opts.port;
         }
 
-        var encodedQuery = encode(query);
-        var ipv6 = this.opts.hostname.indexOf(":") !== -1;
-        return schema + "://" + (ipv6 ? "[" + this.opts.hostname + "]" : this.opts.hostname) + port + this.opts.path + (encodedQuery.length ? "?" + encodedQuery : "");
+        return this.createUri(schema, query);
       }
       /**
        * Creates a request.
        *
        * @param {String} method
-       * @api private
+       * @private
        */
 
     }, {
@@ -1270,7 +1332,7 @@
 
         _extends(opts, {
           xd: this.xd,
-          xs: this.xs
+          cookieJar: this.cookieJar
         }, this.opts);
 
         return new Request(this.uri(), opts);
@@ -1280,7 +1342,7 @@
        *
        * @param {String} data to send.
        * @param {Function} called upon flush.
-       * @api private
+       * @private
        */
 
     }, {
@@ -1300,7 +1362,7 @@
       /**
        * Starts a poll cycle.
        *
-       * @api private
+       * @private
        */
 
     }, {
@@ -1328,7 +1390,7 @@
      * Request constructor
      *
      * @param {Object} options
-     * @api public
+     * @package
      */
     function Request(uri, opts) {
       var _this8;
@@ -1340,7 +1402,6 @@
       _this8.opts = opts;
       _this8.method = opts.method || "GET";
       _this8.uri = uri;
-      _this8.async = false !== opts.async;
       _this8.data = undefined !== opts.data ? opts.data : null;
 
       _this8.create();
@@ -1350,7 +1411,7 @@
     /**
      * Creates the XHR object and sends the request.
      *
-     * @api private
+     * @private
      */
 
 
@@ -1359,13 +1420,14 @@
       value: function create() {
         var _this9 = this;
 
+        var _a;
+
         var opts = pick(this.opts, "agent", "pfx", "key", "passphrase", "cert", "ca", "ciphers", "rejectUnauthorized", "autoUnref");
         opts.xdomain = !!this.opts.xd;
-        opts.xscheme = !!this.opts.xs;
-        var xhr = this.xhr = new XMLHttpRequest$1(opts);
+        var xhr = this.xhr = new XHR(opts);
 
         try {
-          xhr.open(this.method, this.uri, this.async);
+          xhr.open(this.method, this.uri, true);
 
           try {
             if (this.opts.extraHeaders) {
@@ -1387,8 +1449,9 @@
 
           try {
             xhr.setRequestHeader("Accept", "*/*");
-          } catch (e) {} // ie6 check
+          } catch (e) {}
 
+          (_a = this.opts.cookieJar) === null || _a === void 0 ? void 0 : _a.addCookies(xhr); // ie6 check
 
           if ("withCredentials" in xhr) {
             xhr.withCredentials = this.opts.withCredentials;
@@ -1399,6 +1462,12 @@
           }
 
           xhr.onreadystatechange = function () {
+            var _a;
+
+            if (xhr.readyState === 3) {
+              (_a = _this9.opts.cookieJar) === null || _a === void 0 ? void 0 : _a.parseCookies(xhr);
+            }
+
             if (4 !== xhr.readyState) return;
 
             if (200 === xhr.status || 1223 === xhr.status) {
@@ -1431,7 +1500,7 @@
       /**
        * Called upon error.
        *
-       * @api private
+       * @private
        */
 
     }, {
@@ -1443,7 +1512,7 @@
       /**
        * Cleans up house.
        *
-       * @api private
+       * @private
        */
 
     }, {
@@ -1470,7 +1539,7 @@
       /**
        * Called upon load.
        *
-       * @api private
+       * @private
        */
 
     }, {
@@ -1487,7 +1556,7 @@
       /**
        * Aborts the request.
        *
-       * @api public
+       * @package
        */
 
     }, {
@@ -1513,7 +1582,7 @@
       // @ts-ignore
       attachEvent("onunload", unloadHandler);
     } else if (typeof addEventListener === "function") {
-      var terminationEvent = "onpagehide" in globalThis ? "pagehide" : "unload";
+      var terminationEvent = "onpagehide" in globalThisShim ? "pagehide" : "unload";
       addEventListener(terminationEvent, unloadHandler, false);
     }
   }
@@ -1539,7 +1608,7 @@
       };
     }
   }();
-  var WebSocket = globalThis.WebSocket || globalThis.MozWebSocket;
+  var WebSocket = globalThisShim.WebSocket || globalThisShim.MozWebSocket;
   var usingBrowserWebSocket = true;
   var defaultBinaryType = "arraybuffer";
 
@@ -1552,8 +1621,8 @@
     /**
      * WebSocket transport constructor.
      *
-     * @api {Object} connection options
-     * @api public
+     * @param {Object} opts - connection options
+     * @protected
      */
     function WS(opts) {
       var _this;
@@ -1564,24 +1633,12 @@
       _this.supportsBinary = !opts.forceBase64;
       return _this;
     }
-    /**
-     * Transport name.
-     *
-     * @api public
-     */
-
 
     _createClass(WS, [{
       key: "name",
       get: function get() {
         return "websocket";
       }
-      /**
-       * Opens socket.
-       *
-       * @api private
-       */
-
     }, {
       key: "doOpen",
       value: function doOpen() {
@@ -1611,7 +1668,7 @@
       /**
        * Adds event listeners to the socket
        *
-       * @api private
+       * @private
        */
 
     }, {
@@ -1642,13 +1699,6 @@
           return _this2.onError("websocket error", e);
         };
       }
-      /**
-       * Writes data to socket.
-       *
-       * @param {Array} array of packets.
-       * @api private
-       */
-
     }, {
       key: "write",
       value: function write(packets) {
@@ -1690,12 +1740,6 @@
           _loop(i);
         }
       }
-      /**
-       * Closes socket.
-       *
-       * @api private
-       */
-
     }, {
       key: "doClose",
       value: function doClose() {
@@ -1707,20 +1751,14 @@
       /**
        * Generates uri for connection.
        *
-       * @api private
+       * @private
        */
 
     }, {
       key: "uri",
       value: function uri() {
-        var query = this.query || {};
         var schema = this.opts.secure ? "wss" : "ws";
-        var port = ""; // avoid port if default for schema
-
-        if (this.opts.port && ("wss" === schema && Number(this.opts.port) !== 443 || "ws" === schema && Number(this.opts.port) !== 80)) {
-          port = ":" + this.opts.port;
-        } // append timestamp to URI
-
+        var query = this.query || {}; // append timestamp to URI
 
         if (this.opts.timestampRequests) {
           query[this.opts.timestampParam] = yeast();
@@ -1731,41 +1769,170 @@
           query.b64 = 1;
         }
 
-        var encodedQuery = encode(query);
-        var ipv6 = this.opts.hostname.indexOf(":") !== -1;
-        return schema + "://" + (ipv6 ? "[" + this.opts.hostname + "]" : this.opts.hostname) + port + this.opts.path + (encodedQuery.length ? "?" + encodedQuery : "");
+        return this.createUri(schema, query);
       }
       /**
        * Feature detection for WebSocket.
        *
        * @return {Boolean} whether this transport is available.
-       * @api public
+       * @private
        */
 
     }, {
       key: "check",
       value: function check() {
-        return !!WebSocket && !("__initialize" in WebSocket && this.name === WS.prototype.name);
+        return !!WebSocket;
       }
     }]);
 
     return WS;
   }(Transport);
 
+  function shouldIncludeBinaryHeader(packet, encoded) {
+    // 48 === "0".charCodeAt(0) (OPEN packet type)
+    // 54 === "6".charCodeAt(0) (NOOP packet type)
+    return packet.type === "message" && typeof packet.data !== "string" && encoded[0] >= 48 && encoded[0] <= 54;
+  }
+
+  var WT = /*#__PURE__*/function (_Transport) {
+    _inherits(WT, _Transport);
+
+    var _super = _createSuper(WT);
+
+    function WT() {
+      _classCallCheck(this, WT);
+
+      return _super.apply(this, arguments);
+    }
+
+    _createClass(WT, [{
+      key: "name",
+      get: function get() {
+        return "webtransport";
+      }
+    }, {
+      key: "doOpen",
+      value: function doOpen() {
+        var _this = this;
+
+        // @ts-ignore
+        if (typeof WebTransport !== "function") {
+          return;
+        } // @ts-ignore
+
+
+        this.transport = new WebTransport(this.createUri("https"), this.opts.transportOptions[this.name]);
+        this.transport.closed.then(function () {
+          return _this.onClose();
+        }); // note: we could have used async/await, but that would require some additional polyfills
+
+        this.transport.ready.then(function () {
+          _this.transport.createBidirectionalStream().then(function (stream) {
+            var reader = stream.readable.getReader();
+            _this.writer = stream.writable.getWriter();
+            var binaryFlag;
+
+            var read = function read() {
+              reader.read().then(function (_ref) {
+                var done = _ref.done,
+                    value = _ref.value;
+
+                if (done) {
+                  return;
+                }
+
+                if (!binaryFlag && value.byteLength === 1 && value[0] === 54) {
+                  binaryFlag = true;
+                } else {
+                  // TODO expose binarytype
+                  _this.onPacket(decodePacketFromBinary(value, binaryFlag, "arraybuffer"));
+
+                  binaryFlag = false;
+                }
+
+                read();
+              });
+            };
+
+            read();
+            var handshake = _this.query.sid ? "0{\"sid\":\"".concat(_this.query.sid, "\"}") : "0";
+
+            _this.writer.write(new TextEncoder().encode(handshake)).then(function () {
+              return _this.onOpen();
+            });
+          });
+        });
+      }
+    }, {
+      key: "write",
+      value: function write(packets) {
+        var _this2 = this;
+
+        this.writable = false;
+
+        var _loop = function _loop(i) {
+          var packet = packets[i];
+          var lastPacket = i === packets.length - 1;
+          encodePacketToBinary(packet, function (data) {
+            if (shouldIncludeBinaryHeader(packet, data)) {
+              _this2.writer.write(Uint8Array.of(54));
+            }
+
+            _this2.writer.write(data).then(function () {
+              if (lastPacket) {
+                nextTick(function () {
+                  _this2.writable = true;
+
+                  _this2.emitReserved("drain");
+                }, _this2.setTimeoutFn);
+              }
+            });
+          });
+        };
+
+        for (var i = 0; i < packets.length; i++) {
+          _loop(i);
+        }
+      }
+    }, {
+      key: "doClose",
+      value: function doClose() {
+        var _a;
+
+        (_a = this.transport) === null || _a === void 0 ? void 0 : _a.close();
+      }
+    }]);
+
+    return WT;
+  }(Transport);
+
   var transports = {
     websocket: WS,
+    webtransport: WT,
     polling: Polling
   };
 
   // imported from https://github.com/galkn/parseuri
 
   /**
-   * Parses an URI
+   * Parses a URI
+   *
+   * Note: we could also have used the built-in URL object, but it isn't supported on all platforms.
+   *
+   * See:
+   * - https://developer.mozilla.org/en-US/docs/Web/API/URL
+   * - https://caniuse.com/url
+   * - https://www.rfc-editor.org/rfc/rfc3986#appendix-B
+   *
+   * History of the parse() method:
+   * - first commit: https://github.com/socketio/socket.io-client/commit/4ee1d5d94b3906a9c052b459f1a818b15f38f91c
+   * - export into its own module: https://github.com/socketio/engine.io-client/commit/de2c561e4564efeb78f1bdb1ba39ef81b2822cb3
+   * - reimport: https://github.com/socketio/engine.io-client/commit/df32277c3f6d622eec5ed09f493cae3f3391d242
    *
    * @author Steven Levithan <stevenlevithan.com> (MIT license)
    * @api private
    */
-  var re = /^(?:(?![^:@]+:[^:@\/]*@)(http|https|ws|wss):\/\/)?((?:(([^:@]*)(?::([^:@]*))?)?@)?((?:[a-f0-9]{0,4}:){2,7}[a-f0-9]{0,4}|[^:\/?#]*)(?::(\d*))?)(((\/(?:[^?#](?![^?#\/]*\.[^?#\/.]+(?:[?#]|$)))*\/?)?([^?#\/]*))(?:\?([^#]*))?(?:#(.*))?)/;
+  var re = /^(?:(?![^:@\/?#]+:[^:@\/]*@)(http|https|ws|wss):\/\/)?((?:(([^:@\/?#]*)(?::([^:@\/?#]*))?)?@)?((?:[a-f0-9]{0,4}:){2,7}[a-f0-9]{0,4}|[^:\/?#]*)(?::(\d*))?)(((\/(?:[^?#](?![^?#\/]*\.[^?#\/.]+(?:[?#]|$)))*\/?)?([^?#\/]*))(?:\?([^#]*))?(?:#(.*))?)/;
   var parts = ['source', 'protocol', 'authority', 'userInfo', 'user', 'password', 'host', 'port', 'relative', 'path', 'directory', 'file', 'query', 'anchor'];
   function parse(str) {
     var src = str,
@@ -1800,11 +1967,11 @@
     var regx = /\/{2,9}/g,
         names = path.replace(regx, "/").split("/");
 
-    if (path.substr(0, 1) == '/' || path.length === 0) {
+    if (path.slice(0, 1) == '/' || path.length === 0) {
       names.splice(0, 1);
     }
 
-    if (path.substr(path.length - 1, 1) == '/') {
+    if (path.slice(-1) == '/') {
       names.splice(names.length - 1, 1);
     }
 
@@ -1829,9 +1996,8 @@
     /**
      * Socket constructor.
      *
-     * @param {String|Object} uri or options
+     * @param {String|Object} uri - uri or options
      * @param {Object} opts - options
-     * @api public
      */
     function Socket(uri) {
       var _this;
@@ -1841,6 +2007,7 @@
       _classCallCheck(this, Socket);
 
       _this = _super.call(this);
+      _this.writeBuffer = [];
 
       if (uri && "object" === _typeof(uri)) {
         opts = uri;
@@ -1867,8 +2034,7 @@
 
       _this.hostname = opts.hostname || (typeof location !== "undefined" ? location.hostname : "localhost");
       _this.port = opts.port || (typeof location !== "undefined" && location.port ? location.port : _this.secure ? "443" : "80");
-      _this.transports = opts.transports || ["polling", "websocket"];
-      _this.readyState = "";
+      _this.transports = opts.transports || ["polling", "websocket", "webtransport"];
       _this.writeBuffer = [];
       _this.prevBufferLen = 0;
       _this.opts = _extends({
@@ -1878,6 +2044,7 @@
         upgrade: true,
         timestampParam: "t",
         rememberUpgrade: false,
+        addTrailingSlash: true,
         rejectUnauthorized: true,
         perMessageDeflate: {
           threshold: 1024
@@ -1885,7 +2052,7 @@
         transportOptions: {},
         closeOnBeforeunload: true
       }, opts);
-      _this.opts.path = _this.opts.path.replace(/\/$/, "") + "/";
+      _this.opts.path = _this.opts.path.replace(/\/$/, "") + (_this.opts.addTrailingSlash ? "/" : "");
 
       if (typeof _this.opts.query === "string") {
         _this.opts.query = decode(_this.opts.query);
@@ -1904,14 +2071,16 @@
           // Firefox closes the connection when the "beforeunload" event is emitted but not Chrome. This event listener
           // ensures every browser behaves the same (no "disconnect" event at the Socket.IO level when the page is
           // closed/reloaded)
-          addEventListener("beforeunload", function () {
+          _this.beforeunloadEventListener = function () {
             if (_this.transport) {
               // silently close the transport
               _this.transport.removeAllListeners();
 
               _this.transport.close();
             }
-          }, false);
+          };
+
+          addEventListener("beforeunload", _this.beforeunloadEventListener, false);
         }
 
         if (_this.hostname !== "localhost") {
@@ -1932,9 +2101,9 @@
     /**
      * Creates transport of the given type.
      *
-     * @param {String} transport name
+     * @param {String} name - transport name
      * @return {Transport}
-     * @api private
+     * @private
      */
 
 
@@ -1963,7 +2132,7 @@
       /**
        * Initializes transport to use and starts probe.
        *
-       * @api private
+       * @private
        */
 
     }, {
@@ -2001,7 +2170,7 @@
       /**
        * Sets the current transport. Disables the existing one (if any).
        *
-       * @api private
+       * @private
        */
 
     }, {
@@ -2023,8 +2192,8 @@
       /**
        * Probes a transport.
        *
-       * @param {String} transport name
-       * @api private
+       * @param {String} name - transport name
+       * @private
        */
 
     }, {
@@ -2132,12 +2301,22 @@
         transport.once("close", onTransportClose);
         this.once("close", onclose);
         this.once("upgrading", onupgrade);
-        transport.open();
+
+        if (this.upgrades.indexOf("webtransport") !== -1 && name !== "webtransport") {
+          // favor WebTransport
+          this.setTimeoutFn(function () {
+            if (!failed) {
+              transport.open();
+            }
+          }, 200);
+        } else {
+          transport.open();
+        }
       }
       /**
        * Called when connection is deemed open.
        *
-       * @api private
+       * @private
        */
 
     }, {
@@ -2149,7 +2328,7 @@
         this.flush(); // we check for `readyState` in case an `open`
         // listener already closed the socket
 
-        if ("open" === this.readyState && this.opts.upgrade && this.transport.pause) {
+        if ("open" === this.readyState && this.opts.upgrade) {
           var i = 0;
           var l = this.upgrades.length;
 
@@ -2161,7 +2340,7 @@
       /**
        * Handles a packet.
        *
-       * @api private
+       * @private
        */
 
     }, {
@@ -2202,7 +2381,7 @@
        * Called upon handshake completion.
        *
        * @param {Object} data - handshake obj
-       * @api private
+       * @private
        */
 
     }, {
@@ -2223,7 +2402,7 @@
       /**
        * Sets and resets ping timeout timer based on server pings.
        *
-       * @api private
+       * @private
        */
 
     }, {
@@ -2243,7 +2422,7 @@
       /**
        * Called on `drain` event
        *
-       * @api private
+       * @private
        */
 
     }, {
@@ -2264,7 +2443,7 @@
       /**
        * Flush write buffers.
        *
-       * @api private
+       * @private
        */
 
     }, {
@@ -2316,11 +2495,10 @@
       /**
        * Sends a message.
        *
-       * @param {String} message.
-       * @param {Function} callback function.
+       * @param {String} msg - message.
        * @param {Object} options.
+       * @param {Function} callback function.
        * @return {Socket} for chaining.
-       * @api public
        */
 
     }, {
@@ -2338,11 +2516,11 @@
       /**
        * Sends a packet.
        *
-       * @param {String} packet type.
+       * @param {String} type: packet type.
        * @param {String} data.
        * @param {Object} options.
-       * @param {Function} callback function.
-       * @api private
+       * @param {Function} fn - callback function.
+       * @private
        */
 
     }, {
@@ -2376,8 +2554,6 @@
       }
       /**
        * Closes the connection.
-       *
-       * @api public
        */
 
     }, {
@@ -2429,7 +2605,7 @@
       /**
        * Called upon transport error
        *
-       * @api private
+       * @private
        */
 
     }, {
@@ -2442,7 +2618,7 @@
       /**
        * Called upon transport close.
        *
-       * @api private
+       * @private
        */
 
     }, {
@@ -2459,6 +2635,7 @@
           this.transport.removeAllListeners();
 
           if (typeof removeEventListener === "function") {
+            removeEventListener("beforeunload", this.beforeunloadEventListener, false);
             removeEventListener("offline", this.offlineEventListener, false);
           } // set ready state
 
@@ -2477,9 +2654,8 @@
       /**
        * Filters upgrades, returning only those matching client transports.
        *
-       * @param {Array} server upgrades
-       * @api private
-       *
+       * @param {Array} upgrades - server upgrades
+       * @private
        */
 
     }, {
@@ -2501,6 +2677,8 @@
   }(Emitter);
   Socket$1.protocol = protocol$1;
 
+  Socket$1.protocol;
+
   /**
    * URL parser.
    *
@@ -2674,7 +2852,7 @@
 
   function reconstructPacket(packet, buffers) {
     packet.data = _reconstructPacket(packet.data, buffers);
-    packet.attachments = undefined; // no longer useful
+    delete packet.attachments; // no longer useful
 
     return packet;
   }
@@ -2682,8 +2860,14 @@
   function _reconstructPacket(data, buffers) {
     if (!data) return data;
 
-    if (data && data._placeholder) {
-      return buffers[data.num]; // appropriate buffer (should be natural order anyway)
+    if (data && data._placeholder === true) {
+      var isIndexValid = typeof data.num === "number" && data.num >= 0 && data.num < buffers.length;
+
+      if (isIndexValid) {
+        return buffers[data.num]; // appropriate buffer (should be natural order anyway)
+      } else {
+        throw new Error("illegal attachments");
+      }
     } else if (Array.isArray(data)) {
       for (var i = 0; i < data.length; i++) {
         data[i] = _reconstructPacket(data[i], buffers);
@@ -2699,6 +2883,12 @@
     return data;
   }
 
+  /**
+   * These strings must not be used as event names, as they have a special meaning.
+   */
+
+  var RESERVED_EVENTS$1 = ["connect", "connect_error", "disconnect", "disconnecting", "newListener", "removeListener" // used by the Node.js EventEmitter
+  ];
   /**
    * Protocol version.
    *
@@ -2746,8 +2936,12 @@
       value: function encode(obj) {
         if (obj.type === PacketType.EVENT || obj.type === PacketType.ACK) {
           if (hasBinary(obj)) {
-            obj.type = obj.type === PacketType.EVENT ? PacketType.BINARY_EVENT : PacketType.BINARY_ACK;
-            return this.encodeAsBinary(obj);
+            return this.encodeAsBinary({
+              type: obj.type === PacketType.EVENT ? PacketType.BINARY_EVENT : PacketType.BINARY_ACK,
+              nsp: obj.nsp,
+              data: obj.data,
+              id: obj.id
+            });
           }
         }
 
@@ -2804,13 +2998,18 @@
     }]);
 
     return Encoder;
-  }();
+  }(); // see https://stackoverflow.com/questions/8511281/check-if-a-value-is-an-object-in-javascript
+
+  function isObject(value) {
+    return Object.prototype.toString.call(value) === "[object Object]";
+  }
   /**
    * A socket.io Decoder instance
    *
    * @return {Object} decoder
    */
 
+
   var Decoder = /*#__PURE__*/function (_Emitter) {
     _inherits(Decoder, _Emitter);
 
@@ -2843,10 +3042,16 @@
         var packet;
 
         if (typeof obj === "string") {
+          if (this.reconstructor) {
+            throw new Error("got plaintext data when reconstructing a packet");
+          }
+
           packet = this.decodeString(obj);
+          var isBinaryEvent = packet.type === PacketType.BINARY_EVENT;
+
+          if (isBinaryEvent || packet.type === PacketType.BINARY_ACK) {
+            packet.type = isBinaryEvent ? PacketType.EVENT : PacketType.ACK; // binary packet's json
 
-          if (packet.type === PacketType.BINARY_EVENT || packet.type === PacketType.BINARY_ACK) {
-            // binary packet's json
             this.reconstructor = new BinaryReconstructor(packet); // no attachments, labeled binary but no binary data to follow
 
             if (packet.attachments === 0) {
@@ -2975,6 +3180,7 @@
       function destroy() {
         if (this.reconstructor) {
           this.reconstructor.finishedReconstruction();
+          this.reconstructor = null;
         }
       }
     }], [{
@@ -2982,17 +3188,17 @@
       value: function isPayloadValid(type, payload) {
         switch (type) {
           case PacketType.CONNECT:
-            return _typeof(payload) === "object";
+            return isObject(payload);
 
           case PacketType.DISCONNECT:
             return payload === undefined;
 
           case PacketType.CONNECT_ERROR:
-            return typeof payload === "string" || _typeof(payload) === "object";
+            return typeof payload === "string" || isObject(payload);
 
           case PacketType.EVENT:
           case PacketType.BINARY_EVENT:
-            return Array.isArray(payload) && payload.length > 0;
+            return Array.isArray(payload) && (typeof payload[0] === "number" || typeof payload[0] === "string" && RESERVED_EVENTS$1.indexOf(payload[0]) === -1);
 
           case PacketType.ACK:
           case PacketType.BINARY_ACK:
@@ -3088,6 +3294,31 @@
     newListener: 1,
     removeListener: 1
   });
+  /**
+   * A Socket is the fundamental class for interacting with the server.
+   *
+   * A Socket belongs to a certain Namespace (by default /) and uses an underlying {@link Manager} to communicate.
+   *
+   * @example
+   * const socket = io();
+   *
+   * socket.on("connect", () => {
+   *   console.log("connected");
+   * });
+   *
+   * // send an event to the server
+   * socket.emit("foo", "bar");
+   *
+   * socket.on("foobar", () => {
+   *   // an event was received from the server
+   * });
+   *
+   * // upon disconnection
+   * socket.on("disconnect", (reason) => {
+   *   console.log(`disconnected due to ${reason}`);
+   * });
+   */
+
   var Socket = /*#__PURE__*/function (_Emitter) {
     _inherits(Socket, _Emitter);
 
@@ -3095,8 +3326,6 @@
 
     /**
      * `Socket` constructor.
-     *
-     * @public
      */
     function Socket(io, nsp, opts) {
       var _this;
@@ -3104,9 +3333,52 @@
       _classCallCheck(this, Socket);
 
       _this = _super.call(this);
+      /**
+       * Whether the socket is currently connected to the server.
+       *
+       * @example
+       * const socket = io();
+       *
+       * socket.on("connect", () => {
+       *   console.log(socket.connected); // true
+       * });
+       *
+       * socket.on("disconnect", () => {
+       *   console.log(socket.connected); // false
+       * });
+       */
+
       _this.connected = false;
+      /**
+       * Whether the connection state was recovered after a temporary disconnection. In that case, any missed packets will
+       * be transmitted by the server.
+       */
+
+      _this.recovered = false;
+      /**
+       * Buffer for packets received before the CONNECT packet
+       */
+
       _this.receiveBuffer = [];
+      /**
+       * Buffer for packets that will be sent once the socket is connected
+       */
+
       _this.sendBuffer = [];
+      /**
+       * The queue of packets to be sent with retry in case of failure.
+       *
+       * Packets are sent one by one, each waiting for the server acknowledgement, in order to guarantee the delivery order.
+       * @private
+       */
+
+      _this._queue = [];
+      /**
+       * A sequence to generate the ID of the {@link QueuedPacket}.
+       * @private
+       */
+
+      _this._queueSeq = 0;
       _this.ids = 0;
       _this.acks = {};
       _this.flags = {};
@@ -3117,11 +3389,23 @@
         _this.auth = opts.auth;
       }
 
+      _this._opts = _extends({}, opts);
       if (_this.io._autoConnect) _this.open();
       return _this;
     }
     /**
      * Whether the socket is currently disconnected
+     *
+     * @example
+     * const socket = io();
+     *
+     * socket.on("connect", () => {
+     *   console.log(socket.disconnected); // false
+     * });
+     *
+     * socket.on("disconnect", () => {
+     *   console.log(socket.disconnected); // true
+     * });
      */
 
 
@@ -3144,7 +3428,21 @@
         this.subs = [on(io, "open", this.onopen.bind(this)), on(io, "packet", this.onpacket.bind(this)), on(io, "error", this.onerror.bind(this)), on(io, "close", this.onclose.bind(this))];
       }
       /**
-       * Whether the Socket will try to reconnect when its Manager connects or reconnects
+       * Whether the Socket will try to reconnect when its Manager connects or reconnects.
+       *
+       * @example
+       * const socket = io();
+       *
+       * console.log(socket.active); // true
+       *
+       * socket.on("disconnect", (reason) => {
+       *   if (reason === "io server disconnect") {
+       *     // the disconnection was initiated by the server, you need to manually reconnect
+       *     console.log(socket.active); // false
+       *   }
+       *   // else the socket will automatically try to reconnect
+       *   console.log(socket.active); // true
+       * });
        */
 
     }, {
@@ -3155,7 +3453,12 @@
       /**
        * "Opens" the socket.
        *
-       * @public
+       * @example
+       * const socket = io({
+       *   autoConnect: false
+       * });
+       *
+       * socket.connect();
        */
 
     }, {
@@ -3169,7 +3472,7 @@
         return this;
       }
       /**
-       * Alias for connect()
+       * Alias for {@link connect()}.
        */
 
     }, {
@@ -3180,8 +3483,17 @@
       /**
        * Sends a `message` event.
        *
+       * This method mimics the WebSocket.send() method.
+       *
+       * @see https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/send
+       *
+       * @example
+       * socket.send("hello");
+       *
+       * // this is equivalent to
+       * socket.emit("message", "hello");
+       *
        * @return self
-       * @public
        */
 
     }, {
@@ -3199,15 +3511,25 @@
        * Override `emit`.
        * If the event is in `events`, it's emitted normally.
        *
+       * @example
+       * socket.emit("hello", "world");
+       *
+       * // all serializable datastructures are supported (no need to call JSON.stringify)
+       * socket.emit("hello", 1, "2", { 3: ["4"], 5: Uint8Array.from([6]) });
+       *
+       * // with an acknowledgement from the server
+       * socket.emit("hello", "world", (val) => {
+       *   // ...
+       * });
+       *
        * @return self
-       * @public
        */
 
     }, {
       key: "emit",
       value: function emit(ev) {
         if (RESERVED_EVENTS.hasOwnProperty(ev)) {
-          throw new Error('"' + ev + '" is a reserved event name');
+          throw new Error('"' + ev.toString() + '" is a reserved event name');
         }
 
         for (var _len2 = arguments.length, args = new Array(_len2 > 1 ? _len2 - 1 : 0), _key2 = 1; _key2 < _len2; _key2++) {
@@ -3215,6 +3537,13 @@
         }
 
         args.unshift(ev);
+
+        if (this._opts.retries && !this.flags.fromQueue && !this.flags["volatile"]) {
+          this._addToQueue(args);
+
+          return this;
+        }
+
         var packet = {
           type: PacketType.EVENT,
           data: args
@@ -3253,7 +3582,9 @@
       value: function _registerAckCallback(id, ack) {
         var _this2 = this;
 
-        var timeout = this.flags.timeout;
+        var _a;
+
+        var timeout = (_a = this.flags.timeout) !== null && _a !== void 0 ? _a : this._opts.ackTimeout;
 
         if (timeout === undefined) {
           this.acks[id] = ack;
@@ -3284,6 +3615,135 @@
           ack.apply(_this2, [null].concat(args));
         };
       }
+      /**
+       * Emits an event and waits for an acknowledgement
+       *
+       * @example
+       * // without timeout
+       * const response = await socket.emitWithAck("hello", "world");
+       *
+       * // with a specific timeout
+       * try {
+       *   const response = await socket.timeout(1000).emitWithAck("hello", "world");
+       * } catch (err) {
+       *   // the server did not acknowledge the event in the given delay
+       * }
+       *
+       * @return a Promise that will be fulfilled when the server acknowledges the event
+       */
+
+    }, {
+      key: "emitWithAck",
+      value: function emitWithAck(ev) {
+        var _this3 = this;
+
+        for (var _len4 = arguments.length, args = new Array(_len4 > 1 ? _len4 - 1 : 0), _key4 = 1; _key4 < _len4; _key4++) {
+          args[_key4 - 1] = arguments[_key4];
+        }
+
+        // the timeout flag is optional
+        var withErr = this.flags.timeout !== undefined || this._opts.ackTimeout !== undefined;
+        return new Promise(function (resolve, reject) {
+          args.push(function (arg1, arg2) {
+            if (withErr) {
+              return arg1 ? reject(arg1) : resolve(arg2);
+            } else {
+              return resolve(arg1);
+            }
+          });
+
+          _this3.emit.apply(_this3, [ev].concat(args));
+        });
+      }
+      /**
+       * Add the packet to the queue.
+       * @param args
+       * @private
+       */
+
+    }, {
+      key: "_addToQueue",
+      value: function _addToQueue(args) {
+        var _this4 = this;
+
+        var ack;
+
+        if (typeof args[args.length - 1] === "function") {
+          ack = args.pop();
+        }
+
+        var packet = {
+          id: this._queueSeq++,
+          tryCount: 0,
+          pending: false,
+          args: args,
+          flags: _extends({
+            fromQueue: true
+          }, this.flags)
+        };
+        args.push(function (err) {
+          if (packet !== _this4._queue[0]) {
+            // the packet has already been acknowledged
+            return;
+          }
+
+          var hasError = err !== null;
+
+          if (hasError) {
+            if (packet.tryCount > _this4._opts.retries) {
+              _this4._queue.shift();
+
+              if (ack) {
+                ack(err);
+              }
+            }
+          } else {
+            _this4._queue.shift();
+
+            if (ack) {
+              for (var _len5 = arguments.length, responseArgs = new Array(_len5 > 1 ? _len5 - 1 : 0), _key5 = 1; _key5 < _len5; _key5++) {
+                responseArgs[_key5 - 1] = arguments[_key5];
+              }
+
+              ack.apply(void 0, [null].concat(responseArgs));
+            }
+          }
+
+          packet.pending = false;
+          return _this4._drainQueue();
+        });
+
+        this._queue.push(packet);
+
+        this._drainQueue();
+      }
+      /**
+       * Send the first packet of the queue, and wait for an acknowledgement from the server.
+       * @param force - whether to resend a packet that has not been acknowledged yet
+       *
+       * @private
+       */
+
+    }, {
+      key: "_drainQueue",
+      value: function _drainQueue() {
+        var force = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
+
+        if (!this.connected || this._queue.length === 0) {
+          return;
+        }
+
+        var packet = this._queue[0];
+
+        if (packet.pending && !force) {
+          return;
+        }
+
+        packet.pending = true;
+        packet.tryCount++;
+        this.flags = packet.flags;
+        this.emit.apply(this, packet.args);
+      }
       /**
        * Sends a packet.
        *
@@ -3307,22 +3767,34 @@
     }, {
       key: "onopen",
       value: function onopen() {
-        var _this3 = this;
+        var _this5 = this;
 
         if (typeof this.auth == "function") {
           this.auth(function (data) {
-            _this3.packet({
-              type: PacketType.CONNECT,
-              data: data
-            });
+            _this5._sendConnectPacket(data);
           });
         } else {
-          this.packet({
-            type: PacketType.CONNECT,
-            data: this.auth
-          });
+          this._sendConnectPacket(this.auth);
         }
       }
+      /**
+       * Sends a CONNECT packet to initiate the Socket.IO session.
+       *
+       * @param data
+       * @private
+       */
+
+    }, {
+      key: "_sendConnectPacket",
+      value: function _sendConnectPacket(data) {
+        this.packet({
+          type: PacketType.CONNECT,
+          data: this._pid ? _extends({
+            pid: this._pid,
+            offset: this._lastOffset
+          }, data) : data
+        });
+      }
       /**
        * Called upon engine or manager `error`.
        *
@@ -3368,8 +3840,7 @@
         switch (packet.type) {
           case PacketType.CONNECT:
             if (packet.data && packet.data.sid) {
-              var id = packet.data.sid;
-              this.onconnect(id);
+              this.onconnect(packet.data.sid, packet.data.pid);
             } else {
               this.emitReserved("connect_error", new Error("It seems you are trying to reach a Socket.IO server in v2.x with a v3.x client, but they are not compatible (more information here: https://socket.io/docs/v3/migrating-from-2-x-to-3-0/)"));
             }
@@ -3443,6 +3914,10 @@
         }
 
         _get(_getPrototypeOf(Socket.prototype), "emit", this).apply(this, args);
+
+        if (this._pid && args.length && typeof args[args.length - 1] === "string") {
+          this._lastOffset = args[args.length - 1];
+        }
       }
       /**
        * Produces an ack callback to emit with an event.
@@ -3460,8 +3935,8 @@
           if (sent) return;
           sent = true;
 
-          for (var _len4 = arguments.length, args = new Array(_len4), _key4 = 0; _key4 < _len4; _key4++) {
-            args[_key4] = arguments[_key4];
+          for (var _len6 = arguments.length, args = new Array(_len6), _key6 = 0; _key6 < _len6; _key6++) {
+            args[_key6] = arguments[_key6];
           }
 
           self.packet({
@@ -3496,11 +3971,16 @@
 
     }, {
       key: "onconnect",
-      value: function onconnect(id) {
+      value: function onconnect(id, pid) {
         this.id = id;
+        this.recovered = pid && this._pid === pid;
+        this._pid = pid; // defined only if connection state recovery is enabled
+
         this.connected = true;
         this.emitBuffered();
         this.emitReserved("connect");
+
+        this._drainQueue(true);
       }
       /**
        * Emit buffered events (received and emitted).
@@ -3511,16 +3991,16 @@
     }, {
       key: "emitBuffered",
       value: function emitBuffered() {
-        var _this4 = this;
+        var _this6 = this;
 
         this.receiveBuffer.forEach(function (args) {
-          return _this4.emitEvent(args);
+          return _this6.emitEvent(args);
         });
         this.receiveBuffer = [];
         this.sendBuffer.forEach(function (packet) {
-          _this4.notifyOutgoingListeners(packet);
+          _this6.notifyOutgoingListeners(packet);
 
-          _this4.packet(packet);
+          _this6.packet(packet);
         });
         this.sendBuffer = [];
       }
@@ -3558,10 +4038,20 @@
         this.io["_destroy"](this);
       }
       /**
-       * Disconnects the socket manually.
+       * Disconnects the socket manually. In that case, the socket will not try to reconnect.
+       *
+       * If this is the last active Socket instance of the {@link Manager}, the low-level connection will be closed.
+       *
+       * @example
+       * const socket = io();
+       *
+       * socket.on("disconnect", (reason) => {
+       *   // console.log(reason); prints "io client disconnect"
+       * });
+       *
+       * socket.disconnect();
        *
        * @return self
-       * @public
        */
 
     }, {
@@ -3584,10 +4074,9 @@
         return this;
       }
       /**
-       * Alias for disconnect()
+       * Alias for {@link disconnect()}.
        *
        * @return self
-       * @public
        */
 
     }, {
@@ -3598,9 +4087,11 @@
       /**
        * Sets the compress flag.
        *
+       * @example
+       * socket.compress(false).emit("hello");
+       *
        * @param compress - if `true`, compresses the sending data
        * @return self
-       * @public
        */
 
     }, {
@@ -3613,8 +4104,10 @@
        * Sets a modifier for a subsequent event emission that the event message will be dropped when this socket is not
        * ready to send messages.
        *
+       * @example
+       * socket.volatile.emit("hello"); // the server may or may not receive it
+       *
        * @returns self
-       * @public
        */
 
     }, {
@@ -3627,16 +4120,14 @@
        * Sets a modifier for a subsequent event emission that the callback will be called with an error when the
        * given number of milliseconds have elapsed without an acknowledgement from the server:
        *
-       * ```
+       * @example
        * socket.timeout(5000).emit("my-event", (err) => {
        *   if (err) {
        *     // the server did not acknowledge the event in the given delay
        *   }
        * });
-       * ```
        *
        * @returns self
-       * @public
        */
 
     }, {
@@ -3649,8 +4140,12 @@
        * Adds a listener that will be fired when any event is emitted. The event name is passed as the first argument to the
        * callback.
        *
+       * @example
+       * socket.onAny((event, ...args) => {
+       *   console.log(`got ${event}`);
+       * });
+       *
        * @param listener
-       * @public
        */
 
     }, {
@@ -3666,8 +4161,12 @@
        * Adds a listener that will be fired when any event is emitted. The event name is passed as the first argument to the
        * callback. The listener is added to the beginning of the listeners array.
        *
+       * @example
+       * socket.prependAny((event, ...args) => {
+       *   console.log(`got event ${event}`);
+       * });
+       *
        * @param listener
-       * @public
        */
 
     }, {
@@ -3682,8 +4181,20 @@
       /**
        * Removes the listener that will be fired when any event is emitted.
        *
+       * @example
+       * const catchAllListener = (event, ...args) => {
+       *   console.log(`got event ${event}`);
+       * }
+       *
+       * socket.onAny(catchAllListener);
+       *
+       * // remove a specific listener
+       * socket.offAny(catchAllListener);
+       *
+       * // or remove all listeners
+       * socket.offAny();
+       *
        * @param listener
-       * @public
        */
 
     }, {
@@ -3711,8 +4222,6 @@
       /**
        * Returns an array of listeners that are listening for any event that is specified. This array can be manipulated,
        * e.g. to remove listeners.
-       *
-       * @public
        */
 
     }, {
@@ -3724,17 +4233,14 @@
        * Adds a listener that will be fired when any event is emitted. The event name is passed as the first argument to the
        * callback.
        *
-       * @param listener
-       *
-       * <pre><code>
+       * Note: acknowledgements sent to the server are not included.
        *
+       * @example
        * socket.onAnyOutgoing((event, ...args) => {
-       *   console.log(event);
+       *   console.log(`sent event ${event}`);
        * });
        *
-       * </pre></code>
-       *
-       * @public
+       * @param listener
        */
 
     }, {
@@ -3750,17 +4256,14 @@
        * Adds a listener that will be fired when any event is emitted. The event name is passed as the first argument to the
        * callback. The listener is added to the beginning of the listeners array.
        *
-       * @param listener
-       *
-       * <pre><code>
+       * Note: acknowledgements sent to the server are not included.
        *
+       * @example
        * socket.prependAnyOutgoing((event, ...args) => {
-       *   console.log(event);
+       *   console.log(`sent event ${event}`);
        * });
        *
-       * </pre></code>
-       *
-       * @public
+       * @param listener
        */
 
     }, {
@@ -3775,22 +4278,20 @@
       /**
        * Removes the listener that will be fired when any event is emitted.
        *
-       * @param listener
-       *
-       * <pre><code>
-       *
-       * const handler = (event, ...args) => {
-       *   console.log(event);
+       * @example
+       * const catchAllListener = (event, ...args) => {
+       *   console.log(`sent event ${event}`);
        * }
        *
-       * socket.onAnyOutgoing(handler);
+       * socket.onAnyOutgoing(catchAllListener);
        *
-       * // then later
-       * socket.offAnyOutgoing(handler);
+       * // remove a specific listener
+       * socket.offAnyOutgoing(catchAllListener);
        *
-       * </pre></code>
+       * // or remove all listeners
+       * socket.offAnyOutgoing();
        *
-       * @public
+       * @param [listener] - the catch-all listener (optional)
        */
 
     }, {
@@ -3818,8 +4319,6 @@
       /**
        * Returns an array of listeners that are listening for any event that is specified. This array can be manipulated,
        * e.g. to remove listeners.
-       *
-       * @public
        */
 
     }, {
@@ -4085,11 +4584,12 @@
         var openSubDestroy = on(socket, "open", function () {
           self.onopen();
           fn && fn();
-        }); // emit `error`
+        });
+
+        var onError = function onError(err) {
+          _this2.cleanup();
 
-        var errorSub = on(socket, "error", function (err) {
-          self.cleanup();
-          self._readyState = "closed";
+          _this2._readyState = "closed";
 
           _this2.emitReserved("error", err);
 
@@ -4097,31 +4597,28 @@
             fn(err);
           } else {
             // Only do this if there is no fn to handle the error
-            self.maybeReconnectOnOpen();
+            _this2.maybeReconnectOnOpen();
           }
-        });
+        }; // emit `error`
 
-        if (false !== this._timeout) {
-          var timeout = this._timeout;
 
-          if (timeout === 0) {
-            openSubDestroy(); // prevents a race condition with the 'open' event
-          } // set timer
+        var errorSub = on(socket, "error", onError);
 
+        if (false !== this._timeout) {
+          var timeout = this._timeout; // set timer
 
           var timer = this.setTimeoutFn(function () {
             openSubDestroy();
-            socket.close(); // @ts-ignore
-
-            socket.emit("error", new Error("timeout"));
+            onError(new Error("timeout"));
+            socket.close();
           }, timeout);
 
           if (this.opts.autoUnref) {
             timer.unref();
           }
 
-          this.subs.push(function subDestroy() {
-            clearTimeout(timer);
+          this.subs.push(function () {
+            _this2.clearTimeoutFn(timer);
           });
         }
 
@@ -4179,7 +4676,11 @@
     }, {
       key: "ondata",
       value: function ondata(data) {
-        this.decoder.add(data);
+        try {
+          this.decoder.add(data);
+        } catch (e) {
+          this.onclose("parse error", e);
+        }
       }
       /**
        * Called when parser fully decodes a packet.
@@ -4190,7 +4691,12 @@
     }, {
       key: "ondecoded",
       value: function ondecoded(packet) {
-        this.emitReserved("packet", packet);
+        var _this3 = this;
+
+        // the nextTick call prevents an exception in a user-provided event listener from triggering a disconnection due to a "parse error"
+        nextTick(function () {
+          _this3.emitReserved("packet", packet);
+        }, this.setTimeoutFn);
       }
       /**
        * Called upon socket error.
@@ -4218,6 +4724,8 @@
         if (!socket) {
           socket = new Socket(this, nsp, opts);
           this.nsps[nsp] = socket;
+        } else if (this._autoConnect && !socket.active) {
+          socket.connect();
         }
 
         return socket;
@@ -4328,7 +4836,7 @@
     }, {
       key: "reconnect",
       value: function reconnect() {
-        var _this3 = this;
+        var _this4 = this;
 
         if (this._reconnecting || this.skipReconnect) return this;
         var self = this;
@@ -4343,7 +4851,7 @@
           var timer = this.setTimeoutFn(function () {
             if (self.skipReconnect) return;
 
-            _this3.emitReserved("reconnect_attempt", self.backoff.attempts); // check again for the case socket closed in above events
+            _this4.emitReserved("reconnect_attempt", self.backoff.attempts); // check again for the case socket closed in above events
 
 
             if (self.skipReconnect) return;
@@ -4352,7 +4860,7 @@
                 self._reconnecting = false;
                 self.reconnect();
 
-                _this3.emitReserved("reconnect_error", err);
+                _this4.emitReserved("reconnect_error", err);
               } else {
                 self.onreconnect();
               }
@@ -4363,8 +4871,8 @@
             timer.unref();
           }
 
-          this.subs.push(function subDestroy() {
-            clearTimeout(timer);
+          this.subs.push(function () {
+            _this4.clearTimeoutFn(timer);
           });
         }
       }