@binance/derivatives-trading-portfolio-margin 4.0.2 → 5.0.0

package/dist/index.mjs

@@ -8,12 +8,14 @@ var __export = (target, all) => {
 import {
   buildUserAgent,
   ConfigurationRestAPI as ConfigurationRestAPI6,
-  DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_PROD_URL
+  ConfigurationWebsocketStreams as ConfigurationWebsocketStreams2,
+  DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_PROD_URL,
+  DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_PROD_URL
 } from "@binance/common";
 
 // package.json
 var name = "@binance/derivatives-trading-portfolio-margin";
-var version = "4.0.2";
+var version = "5.0.0";
 
 // src/rest-api/index.ts
 var rest_api_exports = {};
@@ -3130,6 +3132,8 @@ var TradeApiAxiosParamCreator = function(configuration) {
      * `OrderId` can only be sent together with symbol
      * If a `pair` is sent, tickers for all symbols of the `pair` will be returned
      * The parameter `fromId` cannot be sent with `startTime` or `endTime`
+     * If `startTime` and `endTime` are both not sent, then the last '24 hours' data will be returned.
+     * The time between `startTime` and `endTime` cannot be longer than 24 hours.
      *
      * Weight: 20 with symbol, 40 with pair
      *
@@ -5236,8 +5240,8 @@ var TradeApiAxiosParamCreator = function(configuration) {
      * Get trades for a specific account and UM symbol.
      *
      *
-     * If `startTime` and `endTime` are both not sent, then the last '24 hours' data will be returned.
-     * The time between `startTime` and `endTime` cannot be longer than 24 hours.
+     * If `startTime` and `endTime` are both not sent, then the last '7 days' data will be returned.
+     * The time between `startTime` and `endTime` cannot be longer than 7 days.
      * The parameter `fromId` cannot be sent with `startTime` or `endTime`.
      *
      * Weight: 5
@@ -5645,6 +5649,8 @@ var TradeApi = class {
    * `OrderId` can only be sent together with symbol
    * If a `pair` is sent, tickers for all symbols of the `pair` will be returned
    * The parameter `fromId` cannot be sent with `startTime` or `endTime`
+   * If `startTime` and `endTime` are both not sent, then the last '24 hours' data will be returned.
+   * The time between `startTime` and `endTime` cannot be longer than 24 hours.
    *
    * Weight: 20 with symbol, 40 with pair
    *
@@ -7117,8 +7123,8 @@ var TradeApi = class {
    * Get trades for a specific account and UM symbol.
    *
    *
-   * If `startTime` and `endTime` are both not sent, then the last '24 hours' data will be returned.
-   * The time between `startTime` and `endTime` cannot be longer than 24 hours.
+   * If `startTime` and `endTime` are both not sent, then the last '7 days' data will be returned.
+   * The time between `startTime` and `endTime` cannot be longer than 7 days.
    * The parameter `fromId` cannot be sent with `startTime` or `endTime`.
    *
    * Weight: 5
@@ -8482,6 +8488,8 @@ var RestAPI = class {
    * `OrderId` can only be sent together with symbol
    * If a `pair` is sent, tickers for all symbols of the `pair` will be returned
    * The parameter `fromId` cannot be sent with `startTime` or `endTime`
+   * If `startTime` and `endTime` are both not sent, then the last '24 hours' data will be returned.
+   * The time between `startTime` and `endTime` cannot be longer than 24 hours.
    *
    * Weight: 20 with symbol, 40 with pair
    *
@@ -9272,8 +9280,8 @@ var RestAPI = class {
    * Get trades for a specific account and UM symbol.
    *
    *
-   * If `startTime` and `endTime` are both not sent, then the last '24 hours' data will be returned.
-   * The time between `startTime` and `endTime` cannot be longer than 24 hours.
+   * If `startTime` and `endTime` are both not sent, then the last '7 days' data will be returned.
+   * The time between `startTime` and `endTime` cannot be longer than 7 days.
    * The parameter `fromId` cannot be sent with `startTime` or `endTime`.
    *
    * Weight: 5
@@ -9349,6 +9357,134 @@ 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 user data WebSocket stream using the provided listen key.
+   * @param listenKey - The listen key for the user data WebSocket stream.
+   * @param id - Optional user data stream ID
+   * @returns A WebSocket stream handler for the user data stream.
+   */
+  userData(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/derivatives-trading-portfolio-margin.ts
 var DerivativesTradingPortfolioMargin = class {
   constructor(config) {
@@ -9365,6 +9501,14 @@ var DerivativesTradingPortfolioMargin = class {
       };
       this.restAPI = new RestAPI(configRestAPI);
     }
+    if (config?.configurationWebsocketStreams) {
+      const configWebsocketStreams = new ConfigurationWebsocketStreams2(
+        config.configurationWebsocketStreams
+      );
+      configWebsocketStreams.wsURL = configWebsocketStreams.wsURL || DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_PROD_URL;
+      configWebsocketStreams.userAgent = userAgent;
+      this.websocketStreams = new WebsocketStreams(configWebsocketStreams);
+    }
   }
 };
 
@@ -9372,6 +9516,8 @@ var DerivativesTradingPortfolioMargin = class {
 import {
   DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_PROD_URL as DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_PROD_URL2,
   DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_TESTNET_URL,
+  DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_PROD_URL as DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_PROD_URL2,
+  DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_TESTNET_URL,
   ConnectorClientError,
   RequiredError,
   UnauthorizedError,
@@ -9388,8 +9534,11 @@ export {
   ConnectorClientError,
   DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_PROD_URL2 as DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_PROD_URL,
   DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_TESTNET_URL,
+  DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_PROD_URL2 as DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_PROD_URL,
+  DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_TESTNET_URL,
   DerivativesTradingPortfolioMargin,
   rest_api_exports as DerivativesTradingPortfolioMarginRestAPI,
+  websocket_streams_exports as DerivativesTradingPortfolioMarginWebsocketStreams,
   ForbiddenError,
   NetworkError,
   NotFoundError,