@binance/margin-trading 5.0.0 → 6.0.0

package/dist/index.mjs

@@ -5,12 +5,17 @@ var __export = (target, all) => {
 };
 
 // src/margin-trading.ts
-import { platform, arch } from "os";
-import { ConfigurationRestAPI as ConfigurationRestAPI9, MARGIN_TRADING_REST_API_PROD_URL } from "@binance/common";
+import {
+  buildUserAgent,
+  ConfigurationRestAPI as ConfigurationRestAPI9,
+  ConfigurationWebsocketStreams as ConfigurationWebsocketStreams2,
+  MARGIN_TRADING_REST_API_PROD_URL,
+  MARGIN_TRADING_WS_STREAMS_PROD_URL
+} from "@binance/common";
 
 // package.json
 var name = "@binance/margin-trading";
-var version = "5.0.0";
+var version = "6.0.0";
 
 // src/rest-api/index.ts
 var rest_api_exports = {};
@@ -5560,25 +5565,179 @@ var RestAPI = class {
   }
 };
 
+// src/websocket-streams/index.ts
+var websocket_streams_exports = {};
+__export(websocket_streams_exports, {
+  WebsocketStreams: () => WebsocketStreams,
+  WebsocketStreamsConnection: () => WebsocketStreamsConnection
+});
+
+// src/websocket-streams/websocket-streams.ts
+import { WebsocketStreamsBase as WebsocketStreamsBase2 } from "@binance/common";
+
+// src/websocket-streams/websocket-streams-connection.ts
+import { createStreamHandler } from "@binance/common";
+var WebsocketStreamsConnection = class {
+  constructor(websocketBase) {
+    this.websocketBase = websocketBase;
+  }
+  /**
+   * Adds an event listener for the specified WebSocket event.
+   * @param event - The WebSocket event to listen for, such as 'open', 'message', 'error', 'close', 'ping', or 'pong'.
+   * @param listener - The callback function to be executed when the event is triggered. The function can accept any number of arguments.
+   */
+  on(event, listener) {
+    this.websocketBase.on(event, listener);
+  }
+  /**
+   * Removes an event listener for the specified WebSocket event.
+   * @param event - The WebSocket event to stop listening for, such as 'open', 'message', 'error', 'close', 'ping', or 'pong'.
+   * @param listener - The callback function that was previously added as the event listener.
+   */
+  off(event, listener) {
+    this.websocketBase.off(event, listener);
+  }
+  /**
+   * Disconnects from the WebSocket server.
+   * If there is no active connection, a warning is logged.
+   * Otherwise, all connections in the connection pool are closed gracefully,
+   * and a message is logged indicating that the connection has been disconnected.
+   * @returns A Promise that resolves when all connections have been closed.
+   * @throws Error if the WebSocket client is not set.
+   */
+  disconnect() {
+    return this.websocketBase.disconnect();
+  }
+  /**
+   * Checks if the WebSocket connection is currently open.
+   * @returns `true` if the connection is open, `false` otherwise.
+   */
+  isConnected() {
+    return this.websocketBase.isConnected();
+  }
+  /**
+   * Sends a ping message to all connected Websocket servers in the pool.
+   * If no connections are ready, a warning is logged.
+   * For each active connection, the ping message is sent, and debug logs provide details.
+   * @throws Error if a Websocket client is not set for a connection.
+   */
+  pingServer() {
+    this.websocketBase.pingServer();
+  }
+  /**
+   * Subscribes to one or multiple WebSocket streams
+   * Handles both single and pool modes
+   * @param stream Single stream name or array of stream names to subscribe to
+   * @param id Optional subscription ID
+   * @returns void
+   */
+  subscribe(stream, id) {
+    this.websocketBase.subscribe(stream, id);
+  }
+  /**
+   * Unsubscribes from one or multiple WebSocket streams
+   * Handles both single and pool modes
+   * @param stream Single stream name or array of stream names to unsubscribe from
+   * @param id Optional unsubscription ID
+   * @returns void
+   */
+  unsubscribe(stream, id) {
+    this.websocketBase.unsubscribe(stream, id);
+  }
+  /**
+   * Checks if the WebSocket connection is subscribed to the specified stream.
+   * @param stream The name of the WebSocket stream to check.
+   * @returns `true` if the connection is subscribed to the stream, `false` otherwise.
+   */
+  isSubscribed(stream) {
+    return this.websocketBase.isSubscribed(stream);
+  }
+  /**
+   * Subscribes to the risk data WebSocket stream using the provided listen key.
+   * @param listenKey - The listen key for the risk data WebSocket stream.
+   * @param id - Optional risk data stream ID
+   * @returns A WebSocket stream handler for the risk data stream.
+   */
+  riskData(listenKey, id) {
+    return createStreamHandler(this.websocketBase, listenKey, id);
+  }
+  /**
+   * Subscribes to the trade data WebSocket stream using the provided listen key.
+   * @param listenKey - The listen key for the trade data WebSocket stream.
+   * @param id - Optional trade data stream ID
+   * @returns A WebSocket stream handler for the trade data stream.
+   */
+  tradeData(listenKey, id) {
+    return createStreamHandler(
+      this.websocketBase,
+      listenKey,
+      id
+    );
+  }
+};
+
+// src/websocket-streams/websocket-streams.ts
+var WebsocketStreams = class {
+  constructor(configuration) {
+    this.configuration = configuration;
+  }
+  /**
+   * Connects to the Binance WebSocket streams and returns a `WebsocketStreamsConnection` instance.
+   *
+   * @param {object} [options] - Optional connection options.
+   * @param {string|string[]} [options.stream] - The stream(s) to connect to.
+   * @param {'single'|'pool'} [options.mode] - The connection mode, either 'single' or 'pool'. Overwrite the `mode` option in the configuration.
+   * @param {number} [options.poolSize] - The number of connections to use in pool mode. Overwrite the `poolSize` option in the configuration.
+   * @returns {Promise<WebsocketStreamsConnection>} - A promise that resolves to a `WebsocketStreamsConnection` instance.
+   */
+  async connect({
+    stream,
+    mode,
+    poolSize
+  } = {}) {
+    const websocketBase = new WebsocketStreamsBase2({
+      ...this.configuration,
+      ...mode && { mode },
+      ...poolSize && { poolSize }
+    });
+    const websocketStreamsConnection = new WebsocketStreamsConnection(websocketBase);
+    await websocketBase.connect(stream);
+    return websocketStreamsConnection;
+  }
+};
+
 // src/margin-trading.ts
 var MarginTrading = class {
   constructor(config) {
+    const userAgent = buildUserAgent(name, version);
     if (config?.configurationRestAPI) {
-      const configRestAPI = new ConfigurationRestAPI9(config.configurationRestAPI);
+      const configRestAPI = new ConfigurationRestAPI9(
+        config.configurationRestAPI
+      );
       configRestAPI.basePath = configRestAPI.basePath || MARGIN_TRADING_REST_API_PROD_URL;
       configRestAPI.baseOptions = configRestAPI.baseOptions || {};
       configRestAPI.baseOptions.headers = {
         ...configRestAPI.baseOptions.headers || {},
-        "User-Agent": `${name}/${version} (Node.js/${process.version}; ${platform()}; ${arch()})`
+        "User-Agent": userAgent
       };
       this.restAPI = new RestAPI(configRestAPI);
     }
+    if (config?.configurationWebsocketStreams) {
+      const configWebsocketStreams = new ConfigurationWebsocketStreams2(
+        config.configurationWebsocketStreams
+      );
+      configWebsocketStreams.wsURL = configWebsocketStreams.wsURL || MARGIN_TRADING_WS_STREAMS_PROD_URL;
+      configWebsocketStreams.userAgent = userAgent;
+      this.websocketStreams = new WebsocketStreams(configWebsocketStreams);
+    }
   }
 };
 
 // src/index.ts
 import {
   MARGIN_TRADING_REST_API_PROD_URL as MARGIN_TRADING_REST_API_PROD_URL2,
+  MARGIN_TRADING_WS_STREAMS_PROD_URL as MARGIN_TRADING_WS_STREAMS_PROD_URL2,
+  MARGIN_TRADING_RISK_WS_STREAMS_PROD_URL,
   ConnectorClientError,
   RequiredError,
   UnauthorizedError,
@@ -5595,8 +5754,11 @@ export {
   ConnectorClientError,
   ForbiddenError,
   MARGIN_TRADING_REST_API_PROD_URL2 as MARGIN_TRADING_REST_API_PROD_URL,
+  MARGIN_TRADING_RISK_WS_STREAMS_PROD_URL,
+  MARGIN_TRADING_WS_STREAMS_PROD_URL2 as MARGIN_TRADING_WS_STREAMS_PROD_URL,
   MarginTrading,
   rest_api_exports as MarginTradingRestAPI,
+  websocket_streams_exports as MarginTradingWebsocketStreams,
   NetworkError,
   NotFoundError,
   RateLimitBanError,