@blade-hq/agent-client 2612.0.0-beta.2 → 2612.0.0-beta.21

package/node_modules/engine.io-client/build/esm/socket.d.ts

@@ -64,7 +64,20 @@ export interface SocketOptions {
      *
      * @default ['polling','websocket', 'webtransport']
      */
-    transports?: ("polling" | "websocket" | "webtransport" | string)[] | TransportCtor[];
+    transports?: TransportName[] | TransportCtor[];
+    /**
+     * A list of low-level transport implementations to use instead of the defaults.
+     *
+     * The order of the array determines the order in which transports are tried.
+     *
+     * @example
+     * import { Fetch, WebSocket } from "engine.io-client";
+     *
+     * const socket = new Socket({
+     *   transportImplementations: [Fetch, WebSocket]
+     * });
+     */
+    transportImplementations?: TransportCtor[];
     /**
      * Whether all the transports should be tested, instead of just the first one.
      *
@@ -197,20 +210,18 @@ export interface SocketOptions {
      */
     protocols?: string | string[];
 }
-type TransportCtor = {
+export type TransportName = "polling" | "websocket" | "webtransport" | (string & {});
+export type TransportCtor = {
     new (o: any): Transport;
 };
-type BaseSocketOptions = Omit<SocketOptions, "transports"> & {
-    transports: TransportCtor[];
-};
-interface HandshakeData {
+export interface HandshakeData {
     sid: string;
     upgrades: string[];
     pingInterval: number;
     pingTimeout: number;
     maxPayload: number;
 }
-interface SocketReservedEvents {
+export interface SocketReservedEvents {
     open: () => void;
     handshake: (data: HandshakeData) => void;
     packet: (packet: Packet) => void;
@@ -229,43 +240,38 @@ interface SocketReservedEvents {
     close: (reason: string, description?: CloseDetails | Error) => void;
 }
 type SocketState = "opening" | "open" | "closing" | "closed";
-interface WriteOptions {
+export interface WriteOptions {
     compress?: boolean;
 }
 /**
  * This class provides a WebSocket-like interface to connect to an Engine.IO server. The connection will be established
- * with one of the available low-level transports, like HTTP long-polling, WebSocket or WebTransport.
+ * with one of the available low-level transports, like HTTP long-polling, WebSocket, or WebTransport.
  *
- * This class comes without upgrade mechanism, which means that it will keep the first low-level transport that
- * successfully establishes the connection.
- *
- * In order to allow tree-shaking, there are no transports included, that's why the `transports` option is mandatory.
+ * This class comes with an upgrade mechanism, which means that once the connection is established with the first
+ * low-level transport, it will try to upgrade to a better transport.
  *
  * @example
- * import { SocketWithoutUpgrade, WebSocket } from "engine.io-client";
+ * import { Socket } from "engine.io-client";
  *
- * const socket = new SocketWithoutUpgrade({
- *   transports: [WebSocket]
- * });
+ * const socket = new Socket();
  *
  * socket.on("open", () => {
  *   socket.send("hello");
  * });
  *
- * @see SocketWithUpgrade
- * @see Socket
  */
-export declare class SocketWithoutUpgrade extends Emitter<Record<never, never>, Record<never, never>, SocketReservedEvents> {
+export declare class Socket extends Emitter<Record<never, never>, Record<never, never>, SocketReservedEvents> {
     id: string;
     transport: Transport;
     binaryType: BinaryType;
     readyState: SocketState;
     writeBuffer: Packet[];
-    protected readonly opts: BaseSocketOptions;
-    protected readonly transports: string[];
+    protected readonly opts: SocketOptions;
+    protected readonly transports: TransportName[];
     protected upgrading: boolean;
     protected setTimeoutFn: typeof setTimeout;
     private _prevBufferLen;
+    private _upgrades;
     private _pingInterval;
     private _pingTimeout;
     private _maxPayload?;
@@ -294,7 +300,9 @@ export declare class SocketWithoutUpgrade extends Emitter<Record<never, never>,
      * @param {String|Object} uri - uri or options
      * @param {Object} opts - options
      */
-    constructor(uri: string | BaseSocketOptions, opts: BaseSocketOptions);
+    constructor();
+    constructor(uri: string, opts?: SocketOptions);
+    constructor(opts: SocketOptions);
     /**
      * Creates transport of the given type.
      *
@@ -315,6 +323,13 @@ export declare class SocketWithoutUpgrade extends Emitter<Record<never, never>,
      * @private
      */
     protected setTransport(transport: Transport): void;
+    /**
+     * Probes a transport.
+     *
+     * @param {String} name - transport name
+     * @private
+     */
+    private _probe;
     /**
      * Called when connection is deemed open.
      *
@@ -390,7 +405,7 @@ export declare class SocketWithoutUpgrade extends Emitter<Record<never, never>,
     /**
      * Sends a packet.
      *
-     * @param {String} type: packet type.
+     * @param {String} type - packet type.
      * @param {String} data.
      * @param {Object} options.
      * @param {Function} fn - callback function.
@@ -413,41 +428,6 @@ export declare class SocketWithoutUpgrade extends Emitter<Record<never, never>,
      * @private
      */
     private _onClose;
-}
-/**
- * This class provides a WebSocket-like interface to connect to an Engine.IO server. The connection will be established
- * with one of the available low-level transports, like HTTP long-polling, WebSocket or WebTransport.
- *
- * This class comes with an upgrade mechanism, which means that once the connection is established with the first
- * low-level transport, it will try to upgrade to a better transport.
- *
- * In order to allow tree-shaking, there are no transports included, that's why the `transports` option is mandatory.
- *
- * @example
- * import { SocketWithUpgrade, WebSocket } from "engine.io-client";
- *
- * const socket = new SocketWithUpgrade({
- *   transports: [WebSocket]
- * });
- *
- * socket.on("open", () => {
- *   socket.send("hello");
- * });
- *
- * @see SocketWithoutUpgrade
- * @see Socket
- */
-export declare class SocketWithUpgrade extends SocketWithoutUpgrade {
-    private _upgrades;
-    onOpen(): void;
-    /**
-     * Probes a transport.
-     *
-     * @param {String} name - transport name
-     * @private
-     */
-    private _probe;
-    onHandshake(data: HandshakeData): void;
     /**
      * Filters upgrades, returning only those matching client transports.
      *
@@ -456,27 +436,4 @@ export declare class SocketWithUpgrade extends SocketWithoutUpgrade {
      */
     private _filterUpgrades;
 }
-/**
- * This class provides a WebSocket-like interface to connect to an Engine.IO server. The connection will be established
- * with one of the available low-level transports, like HTTP long-polling, WebSocket or WebTransport.
- *
- * This class comes with an upgrade mechanism, which means that once the connection is established with the first
- * low-level transport, it will try to upgrade to a better transport.
- *
- * @example
- * import { Socket } from "engine.io-client";
- *
- * const socket = new Socket();
- *
- * socket.on("open", () => {
- *   socket.send("hello");
- * });
- *
- * @see SocketWithoutUpgrade
- * @see SocketWithUpgrade
- */
-export declare class Socket extends SocketWithUpgrade {
-    constructor(uri?: string, opts?: SocketOptions);
-    constructor(opts: SocketOptions);
-}
 export {};

package/node_modules/engine.io-client/build/esm/socket.js

@@ -17,39 +17,29 @@ if (withEventListeners) {
 }
 /**
  * This class provides a WebSocket-like interface to connect to an Engine.IO server. The connection will be established
- * with one of the available low-level transports, like HTTP long-polling, WebSocket or WebTransport.
+ * with one of the available low-level transports, like HTTP long-polling, WebSocket, or WebTransport.
  *
- * This class comes without upgrade mechanism, which means that it will keep the first low-level transport that
- * successfully establishes the connection.
- *
- * In order to allow tree-shaking, there are no transports included, that's why the `transports` option is mandatory.
+ * This class comes with an upgrade mechanism, which means that once the connection is established with the first
+ * low-level transport, it will try to upgrade to a better transport.
  *
  * @example
- * import { SocketWithoutUpgrade, WebSocket } from "engine.io-client";
+ * import { Socket } from "engine.io-client";
  *
- * const socket = new SocketWithoutUpgrade({
- *   transports: [WebSocket]
- * });
+ * const socket = new Socket();
  *
  * socket.on("open", () => {
  *   socket.send("hello");
  * });
  *
- * @see SocketWithUpgrade
- * @see Socket
  */
-export class SocketWithoutUpgrade extends Emitter {
-    /**
-     * Socket constructor.
-     *
-     * @param {String|Object} uri - uri or options
-     * @param {Object} opts - options
-     */
-    constructor(uri, opts) {
+export class Socket extends Emitter {
+    constructor(uri, opts = {}) {
+        var _a, _b;
         super();
         this.binaryType = defaultBinaryType;
         this.writeBuffer = [];
         this._prevBufferLen = 0;
+        this._upgrades = [];
         this._pingInterval = -1;
         this._pingTimeout = -1;
         this._maxPayload = -1;
@@ -93,13 +83,26 @@ export class SocketWithoutUpgrade extends Emitter {
                     : this.secure
                         ? "443"
                         : "80");
-        this.transports = [];
-        this._transportsByName = {};
-        opts.transports.forEach((t) => {
-            const transportName = t.prototype.name;
-            this.transports.push(transportName);
-            this._transportsByName[transportName] = t;
-        });
+        if (opts.transportImplementations && opts.transports) {
+            throw new Error("specifying both 'transportImplementations' and 'transports' options is not supported");
+        }
+        if (opts.transportImplementations ||
+            (((_a = opts.transports) === null || _a === void 0 ? void 0 : _a.length) && typeof opts.transports[0] === "function")) {
+            // 'transports' option as an array of transport implementations is kept for backward compatibility
+            this.transports = [];
+            this._transportsByName = Object.create(null);
+            ((_b = opts.transportImplementations) !== null && _b !== void 0 ? _b : opts.transports).forEach((t) => {
+                const transportName = t.prototype.name;
+                this.transports.push(transportName);
+                this._transportsByName[transportName] = t;
+            });
+        }
+        else {
+            this.transports = opts.transports
+                ? [...opts.transports]
+                : ["polling", "websocket", "webtransport"];
+            this._transportsByName = DEFAULT_TRANSPORTS;
+        }
         this.opts = Object.assign({
             path: "/engine.io",
             agent: false,
@@ -188,7 +191,7 @@ export class SocketWithoutUpgrade extends Emitter {
             return;
         }
         const transportName = this.opts.rememberUpgrade &&
-            SocketWithoutUpgrade.priorWebsocketSuccess &&
+            Socket.priorWebsocketSuccess &&
             this.transports.indexOf("websocket") !== -1
             ? "websocket"
             : this.transports[0];
@@ -215,6 +218,107 @@ export class SocketWithoutUpgrade extends Emitter {
             .on("error", this._onError.bind(this))
             .on("close", (reason) => this._onClose("transport close", reason));
     }
+    /**
+     * Probes a transport.
+     *
+     * @param {String} name - transport name
+     * @private
+     */
+    _probe(name) {
+        let transport = this.createTransport(name);
+        let failed = false;
+        Socket.priorWebsocketSuccess = false;
+        const onTransportOpen = () => {
+            if (failed)
+                return;
+            transport.send([{ type: "ping", data: "probe" }]);
+            transport.once("packet", (msg) => {
+                if (failed)
+                    return;
+                if ("pong" === msg.type && "probe" === msg.data) {
+                    this.upgrading = true;
+                    this.emitReserved("upgrading", transport);
+                    if (!transport)
+                        return;
+                    Socket.priorWebsocketSuccess = "websocket" === transport.name;
+                    this.transport.pause(() => {
+                        if (failed)
+                            return;
+                        if ("closed" === this.readyState)
+                            return;
+                        cleanup();
+                        this.setTransport(transport);
+                        transport.send([{ type: "upgrade" }]);
+                        this.emitReserved("upgrade", transport);
+                        transport = null;
+                        this.upgrading = false;
+                        this.flush();
+                    });
+                }
+                else {
+                    const err = new Error("probe error");
+                    // @ts-ignore
+                    err.transport = transport.name;
+                    this.emitReserved("upgradeError", err);
+                }
+            });
+        };
+        function freezeTransport() {
+            if (failed)
+                return;
+            // Any callback called by transport should be ignored since now
+            failed = true;
+            cleanup();
+            transport.close();
+            transport = null;
+        }
+        // Handle any error that happens while probing
+        const onerror = (err) => {
+            const error = new Error("probe error: " + err);
+            // @ts-ignore
+            error.transport = transport.name;
+            freezeTransport();
+            this.emitReserved("upgradeError", error);
+        };
+        function onTransportClose() {
+            onerror("transport closed");
+        }
+        // When the socket is closed while we're probing
+        function onclose() {
+            onerror("socket closed");
+        }
+        // When the socket is upgraded while we're probing
+        function onupgrade(to) {
+            if (transport && to.name !== transport.name) {
+                freezeTransport();
+            }
+        }
+        // Remove all listeners on the transport and on self
+        const cleanup = () => {
+            transport.removeListener("open", onTransportOpen);
+            transport.removeListener("error", onerror);
+            transport.removeListener("close", onTransportClose);
+            this.off("close", onclose);
+            this.off("upgrading", onupgrade);
+        };
+        transport.once("open", onTransportOpen);
+        transport.once("error", onerror);
+        transport.once("close", onTransportClose);
+        this.once("close", onclose);
+        this.once("upgrading", onupgrade);
+        if (this._upgrades.indexOf("webtransport") !== -1 &&
+            name !== "webtransport") {
+            // favor WebTransport
+            this.setTimeoutFn(() => {
+                if (!failed) {
+                    transport.open();
+                }
+            }, 200);
+        }
+        else {
+            transport.open();
+        }
+    }
     /**
      * Called when connection is deemed open.
      *
@@ -222,10 +326,14 @@ export class SocketWithoutUpgrade extends Emitter {
      */
     onOpen() {
         this.readyState = "open";
-        SocketWithoutUpgrade.priorWebsocketSuccess =
-            "websocket" === this.transport.name;
+        Socket.priorWebsocketSuccess = "websocket" === this.transport.name;
         this.emitReserved("open");
         this.flush();
+        if ("open" === this.readyState && this.opts.upgrade) {
+            for (let i = 0; i < this._upgrades.length; i++) {
+                this._probe(this._upgrades[i]);
+            }
+        }
     }
     /**
      * Handles a packet.
@@ -274,6 +382,7 @@ export class SocketWithoutUpgrade extends Emitter {
         this.emitReserved("handshake", data);
         this.id = data.sid;
         this.transport.query.sid = data.sid;
+        this._upgrades = this._filterUpgrades(data.upgrades);
         this._pingInterval = data.pingInterval;
         this._pingTimeout = data.pingTimeout;
         this._maxPayload = data.maxPayload;
@@ -409,7 +518,7 @@ export class SocketWithoutUpgrade extends Emitter {
     /**
      * Sends a packet.
      *
-     * @param {String} type: packet type.
+     * @param {String} type - packet type.
      * @param {String} data.
      * @param {Object} options.
      * @param {Function} fn - callback function.
@@ -485,7 +594,7 @@ export class SocketWithoutUpgrade extends Emitter {
      * @private
      */
     _onError(err) {
-        SocketWithoutUpgrade.priorWebsocketSuccess = false;
+        Socket.priorWebsocketSuccess = false;
         if (this.opts.tryAllTransports &&
             this.transports.length > 1 &&
             this.readyState === "opening") {
@@ -535,150 +644,6 @@ export class SocketWithoutUpgrade extends Emitter {
             this._prevBufferLen = 0;
         }
     }
-}
-SocketWithoutUpgrade.protocol = protocol;
-/**
- * This class provides a WebSocket-like interface to connect to an Engine.IO server. The connection will be established
- * with one of the available low-level transports, like HTTP long-polling, WebSocket or WebTransport.
- *
- * This class comes with an upgrade mechanism, which means that once the connection is established with the first
- * low-level transport, it will try to upgrade to a better transport.
- *
- * In order to allow tree-shaking, there are no transports included, that's why the `transports` option is mandatory.
- *
- * @example
- * import { SocketWithUpgrade, WebSocket } from "engine.io-client";
- *
- * const socket = new SocketWithUpgrade({
- *   transports: [WebSocket]
- * });
- *
- * socket.on("open", () => {
- *   socket.send("hello");
- * });
- *
- * @see SocketWithoutUpgrade
- * @see Socket
- */
-export class SocketWithUpgrade extends SocketWithoutUpgrade {
-    constructor() {
-        super(...arguments);
-        this._upgrades = [];
-    }
-    onOpen() {
-        super.onOpen();
-        if ("open" === this.readyState && this.opts.upgrade) {
-            for (let i = 0; i < this._upgrades.length; i++) {
-                this._probe(this._upgrades[i]);
-            }
-        }
-    }
-    /**
-     * Probes a transport.
-     *
-     * @param {String} name - transport name
-     * @private
-     */
-    _probe(name) {
-        let transport = this.createTransport(name);
-        let failed = false;
-        SocketWithoutUpgrade.priorWebsocketSuccess = false;
-        const onTransportOpen = () => {
-            if (failed)
-                return;
-            transport.send([{ type: "ping", data: "probe" }]);
-            transport.once("packet", (msg) => {
-                if (failed)
-                    return;
-                if ("pong" === msg.type && "probe" === msg.data) {
-                    this.upgrading = true;
-                    this.emitReserved("upgrading", transport);
-                    if (!transport)
-                        return;
-                    SocketWithoutUpgrade.priorWebsocketSuccess =
-                        "websocket" === transport.name;
-                    this.transport.pause(() => {
-                        if (failed)
-                            return;
-                        if ("closed" === this.readyState)
-                            return;
-                        cleanup();
-                        this.setTransport(transport);
-                        transport.send([{ type: "upgrade" }]);
-                        this.emitReserved("upgrade", transport);
-                        transport = null;
-                        this.upgrading = false;
-                        this.flush();
-                    });
-                }
-                else {
-                    const err = new Error("probe error");
-                    // @ts-ignore
-                    err.transport = transport.name;
-                    this.emitReserved("upgradeError", err);
-                }
-            });
-        };
-        function freezeTransport() {
-            if (failed)
-                return;
-            // Any callback called by transport should be ignored since now
-            failed = true;
-            cleanup();
-            transport.close();
-            transport = null;
-        }
-        // Handle any error that happens while probing
-        const onerror = (err) => {
-            const error = new Error("probe error: " + err);
-            // @ts-ignore
-            error.transport = transport.name;
-            freezeTransport();
-            this.emitReserved("upgradeError", error);
-        };
-        function onTransportClose() {
-            onerror("transport closed");
-        }
-        // When the socket is closed while we're probing
-        function onclose() {
-            onerror("socket closed");
-        }
-        // When the socket is upgraded while we're probing
-        function onupgrade(to) {
-            if (transport && to.name !== transport.name) {
-                freezeTransport();
-            }
-        }
-        // Remove all listeners on the transport and on self
-        const cleanup = () => {
-            transport.removeListener("open", onTransportOpen);
-            transport.removeListener("error", onerror);
-            transport.removeListener("close", onTransportClose);
-            this.off("close", onclose);
-            this.off("upgrading", onupgrade);
-        };
-        transport.once("open", onTransportOpen);
-        transport.once("error", onerror);
-        transport.once("close", onTransportClose);
-        this.once("close", onclose);
-        this.once("upgrading", onupgrade);
-        if (this._upgrades.indexOf("webtransport") !== -1 &&
-            name !== "webtransport") {
-            // favor WebTransport
-            this.setTimeoutFn(() => {
-                if (!failed) {
-                    transport.open();
-                }
-            }, 200);
-        }
-        else {
-            transport.open();
-        }
-    }
-    onHandshake(data) {
-        this._upgrades = this._filterUpgrades(data.upgrades);
-        super.onHandshake(data);
-    }
     /**
      * Filters upgrades, returning only those matching client transports.
      *
@@ -694,34 +659,4 @@ export class SocketWithUpgrade extends SocketWithoutUpgrade {
         return filteredUpgrades;
     }
 }
-/**
- * This class provides a WebSocket-like interface to connect to an Engine.IO server. The connection will be established
- * with one of the available low-level transports, like HTTP long-polling, WebSocket or WebTransport.
- *
- * This class comes with an upgrade mechanism, which means that once the connection is established with the first
- * low-level transport, it will try to upgrade to a better transport.
- *
- * @example
- * import { Socket } from "engine.io-client";
- *
- * const socket = new Socket();
- *
- * socket.on("open", () => {
- *   socket.send("hello");
- * });
- *
- * @see SocketWithoutUpgrade
- * @see SocketWithUpgrade
- */
-export class Socket extends SocketWithUpgrade {
-    constructor(uri, opts = {}) {
-        const o = typeof uri === "object" ? uri : opts;
-        if (!o.transports ||
-            (o.transports && typeof o.transports[0] === "string")) {
-            o.transports = (o.transports || ["polling", "websocket", "webtransport"])
-                .map((transportName) => DEFAULT_TRANSPORTS[transportName])
-                .filter((t) => !!t);
-        }
-        super(uri, o);
-    }
-}
+Socket.protocol = protocol;

package/node_modules/engine.io-client/build/esm/transport.d.ts

@@ -11,7 +11,7 @@ export interface CloseDetails {
     description: string;
     context?: unknown;
 }
-interface TransportReservedEvents {
+export interface TransportReservedEvents {
     open: () => void;
     error: (err: TransportError) => void;
     packet: (packet: Packet) => void;

package/node_modules/engine.io-client/build/esm/transports/polling-xhr.d.ts

@@ -22,11 +22,11 @@ export declare abstract class BaseXHR extends Polling {
     /**
      * Sends data.
      *
-     * @param {String} data to send.
-     * @param {Function} called upon flush.
+     * @param {String} data - data to send.
+     * @param {Function} fn - called upon flush.
      * @private
      */
-    doWrite(data: any, fn: any): void;
+    doWrite(data: string, fn: () => void): void;
     /**
      * Starts a poll cycle.
      *
@@ -62,7 +62,7 @@ export declare class Request extends Emitter<Record<never, never>, Record<never,
      * @param {Object} options
      * @package
      */
-    constructor(createRequest: (opts: RequestOptions) => XMLHttpRequest, uri: string, opts: RequestOptions);
+    constructor(createRequest: (opts: RequestOptions) => any, uri: string, opts: RequestOptions);
     /**
      * Creates the XHR object and sends the request.
      *

package/node_modules/engine.io-client/build/esm/transports/polling-xhr.js

@@ -29,8 +29,8 @@ export class BaseXHR extends Polling {
     /**
      * Sends data.
      *
-     * @param {String} data to send.
-     * @param {Function} called upon flush.
+     * @param {String} data - data to send.
+     * @param {Function} fn - called upon flush.
      * @private
      */
     doWrite(data, fn) {