@binance/margin-trading 5.0.1 → 6.0.0

package/dist/index.js

@@ -20,28 +20,31 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  BadRequestError: () => import_common10.BadRequestError,
-  ConnectorClientError: () => import_common10.ConnectorClientError,
-  ForbiddenError: () => import_common10.ForbiddenError,
-  MARGIN_TRADING_REST_API_PROD_URL: () => import_common10.MARGIN_TRADING_REST_API_PROD_URL,
+  BadRequestError: () => import_common12.BadRequestError,
+  ConnectorClientError: () => import_common12.ConnectorClientError,
+  ForbiddenError: () => import_common12.ForbiddenError,
+  MARGIN_TRADING_REST_API_PROD_URL: () => import_common12.MARGIN_TRADING_REST_API_PROD_URL,
+  MARGIN_TRADING_RISK_WS_STREAMS_PROD_URL: () => import_common12.MARGIN_TRADING_RISK_WS_STREAMS_PROD_URL,
+  MARGIN_TRADING_WS_STREAMS_PROD_URL: () => import_common12.MARGIN_TRADING_WS_STREAMS_PROD_URL,
   MarginTrading: () => MarginTrading,
   MarginTradingRestAPI: () => rest_api_exports,
-  NetworkError: () => import_common10.NetworkError,
-  NotFoundError: () => import_common10.NotFoundError,
-  RateLimitBanError: () => import_common10.RateLimitBanError,
-  RequiredError: () => import_common10.RequiredError,
-  ServerError: () => import_common10.ServerError,
-  TooManyRequestsError: () => import_common10.TooManyRequestsError,
-  UnauthorizedError: () => import_common10.UnauthorizedError
+  MarginTradingWebsocketStreams: () => websocket_streams_exports,
+  NetworkError: () => import_common12.NetworkError,
+  NotFoundError: () => import_common12.NotFoundError,
+  RateLimitBanError: () => import_common12.RateLimitBanError,
+  RequiredError: () => import_common12.RequiredError,
+  ServerError: () => import_common12.ServerError,
+  TooManyRequestsError: () => import_common12.TooManyRequestsError,
+  UnauthorizedError: () => import_common12.UnauthorizedError
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/margin-trading.ts
-var import_common9 = require("@binance/common");
+var import_common11 = require("@binance/common");
 
 // package.json
 var name = "@binance/margin-trading";
-var version = "5.0.1";
+var version = "6.0.0";
 
 // src/rest-api/index.ts
 var rest_api_exports = {};
@@ -5570,15 +5573,156 @@ 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
+var import_common10 = require("@binance/common");
+
+// src/websocket-streams/websocket-streams-connection.ts
+var import_common9 = require("@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 (0, import_common9.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 (0, import_common9.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 import_common10.WebsocketStreamsBase({
+      ...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 = (0, import_common9.buildUserAgent)(name, version);
+    const userAgent = (0, import_common11.buildUserAgent)(name, version);
     if (config?.configurationRestAPI) {
-      const configRestAPI = new import_common9.ConfigurationRestAPI(
+      const configRestAPI = new import_common11.ConfigurationRestAPI(
         config.configurationRestAPI
       );
-      configRestAPI.basePath = configRestAPI.basePath || import_common9.MARGIN_TRADING_REST_API_PROD_URL;
+      configRestAPI.basePath = configRestAPI.basePath || import_common11.MARGIN_TRADING_REST_API_PROD_URL;
       configRestAPI.baseOptions = configRestAPI.baseOptions || {};
       configRestAPI.baseOptions.headers = {
         ...configRestAPI.baseOptions.headers || {},
@@ -5586,19 +5730,30 @@ var MarginTrading = class {
       };
       this.restAPI = new RestAPI(configRestAPI);
     }
+    if (config?.configurationWebsocketStreams) {
+      const configWebsocketStreams = new import_common11.ConfigurationWebsocketStreams(
+        config.configurationWebsocketStreams
+      );
+      configWebsocketStreams.wsURL = configWebsocketStreams.wsURL || import_common11.MARGIN_TRADING_WS_STREAMS_PROD_URL;
+      configWebsocketStreams.userAgent = userAgent;
+      this.websocketStreams = new WebsocketStreams(configWebsocketStreams);
+    }
   }
 };
 
 // src/index.ts
-var import_common10 = require("@binance/common");
+var import_common12 = require("@binance/common");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BadRequestError,
   ConnectorClientError,
   ForbiddenError,
   MARGIN_TRADING_REST_API_PROD_URL,
+  MARGIN_TRADING_RISK_WS_STREAMS_PROD_URL,
+  MARGIN_TRADING_WS_STREAMS_PROD_URL,
   MarginTrading,
   MarginTradingRestAPI,
+  MarginTradingWebsocketStreams,
   NetworkError,
   NotFoundError,
   RateLimitBanError,