@binance/common 1.0.0 → 1.0.2

package/dist/index.mjs

@@ -61,26 +61,12 @@ var TimeUnit = {
   MICROSECOND: "MICROSECOND",
   microsecond: "microsecond"
 };
-var SPOT_REST_API_PROD_URL = "https://api.binance.com";
-var SPOT_REST_API_TESTNET_URL = "https://testnet.binance.vision";
-var SPOT_WS_API_PROD_URL = "wss://ws-api.binance.com:443/ws-api/v3";
-var SPOT_WS_API_TESTNET_URL = "wss://ws-api.testnet.binance.vision/ws-api/v3";
-var SPOT_WS_STREAMS_PROD_URL = "wss://stream.binance.com:9443";
-var SPOT_WS_STREAMS_TESTNET_URL = "wss://stream.testnet.binance.vision";
-var SPOT_REST_API_MARKET_URL = "https://data-api.binance.vision";
-var SPOT_WS_STREAMS_MARKET_URL = "wss://data-stream.binance.vision";
 var ALGO_REST_API_PROD_URL = "https://api.binance.com";
-var ALGO_REST_API_TESTNET_URL = "https://testnet.binance.vision";
 var AUTO_INVEST_REST_API_PROD_URL = "https://api.binance.com";
-var AUTO_INVEST_REST_API_TESTNET_URL = "https://testnet.binance.vision";
 var C2C_REST_API_PROD_URL = "https://api.binance.com";
-var C2C_REST_API_TESTNET_URL = "https://testnet.binance.vision";
 var CONVERT_REST_API_PROD_URL = "https://api.binance.com";
-var CONVERT_REST_API_TESTNET_URL = "https://testnet.binance.vision";
 var COPY_TRADING_REST_API_PROD_URL = "https://api.binance.com";
-var COPY_TRADING_REST_API_TESTNET_URL = "https://testnet.binance.vision";
 var CRYPTO_LOAN_REST_API_PROD_URL = "https://api.binance.com";
-var CRYPTO_LOAN_REST_API_TESTNET_URL = "https://testnet.binance.vision";
 var DERIVATIVES_TRADING_COIN_FUTURES_REST_API_PROD_URL = "https://dapi.binance.com";
 var DERIVATIVES_TRADING_COIN_FUTURES_REST_API_TESTNET_URL = "https://testnet.binancefuture.com";
 var DERIVATIVES_TRADING_COIN_FUTURES_WS_API_PROD_URL = "wss://ws-dapi.binance.com/ws-dapi/v1";
@@ -100,31 +86,26 @@ var DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_TESTNET_URL = "https://testnet
 var DERIVATIVES_TRADING_PORTFOLIO_MARGIN_PRO_REST_API_PROD_URL = "https://fapi.binance.com";
 var DERIVATIVES_TRADING_PORTFOLIO_MARGIN_PRO_REST_API_TESTNET_URL = "https://testnet.binancefuture.com";
 var DUAL_INVESTMENT_REST_API_PROD_URL = "https://api.binance.com";
-var DUAL_INVESTMENT_REST_API_TESTNET_URL = "https://testnet.binance.vision";
 var FIAT_REST_API_PROD_URL = "https://api.binance.com";
-var FIAT_REST_API_TESTNET_URL = "https://testnet.binance.vision";
 var GIFT_CARD_REST_API_PROD_URL = "https://api.binance.com";
-var GIFT_CARD_REST_API_TESTNET_URL = "https://testnet.binance.vision";
 var MARGIN_TRADING_REST_API_PROD_URL = "https://api.binance.com";
-var MARGIN_TRADING_REST_API_TESTNET_URL = "https://testnet.binance.vision";
 var MINING_REST_API_PROD_URL = "https://api.binance.com";
-var MINING_REST_API_TESTNET_URL = "https://testnet.binance.vision";
 var NFT_REST_API_PROD_URL = "https://api.binance.com";
-var NFT_REST_API_TESTNET_URL = "https://testnet.binance.vision";
 var PAY_REST_API_PROD_URL = "https://api.binance.com";
-var PAY_REST_API_TESTNET_URL = "https://testnet.binance.vision";
 var REBATE_REST_API_PROD_URL = "https://api.binance.com";
-var REBATE_REST_API_TESTNET_URL = "https://testnet.binance.vision";
 var SIMPLE_EARN_REST_API_PROD_URL = "https://api.binance.com";
-var SIMPLE_EARN_REST_API_TESTNET_URL = "https://testnet.binance.vision";
+var SPOT_REST_API_PROD_URL = "https://api.binance.com";
+var SPOT_REST_API_TESTNET_URL = "https://testnet.binance.vision";
+var SPOT_WS_API_PROD_URL = "wss://ws-api.binance.com:443/ws-api/v3";
+var SPOT_WS_API_TESTNET_URL = "wss://ws-api.testnet.binance.vision/ws-api/v3";
+var SPOT_WS_STREAMS_PROD_URL = "wss://stream.binance.com:9443";
+var SPOT_WS_STREAMS_TESTNET_URL = "wss://stream.testnet.binance.vision";
+var SPOT_REST_API_MARKET_URL = "https://data-api.binance.vision";
+var SPOT_WS_STREAMS_MARKET_URL = "wss://data-stream.binance.vision";
 var STAKING_REST_API_PROD_URL = "https://api.binance.com";
-var STAKING_REST_API_TESTNET_URL = "https://testnet.binance.vision";
 var SUB_ACCOUNT_REST_API_PROD_URL = "https://api.binance.com";
-var SUB_ACCOUNT_REST_API_TESTNET_URL = "https://testnet.binance.vision";
 var VIP_LOAN_REST_API_PROD_URL = "https://api.binance.com";
-var VIP_LOAN_REST_API_TESTNET_URL = "https://testnet.binance.vision";
 var WALLET_REST_API_PROD_URL = "https://api.binance.com";
-var WALLET_REST_API_TESTNET_URL = "https://testnet.binance.vision";
 
 // src/errors.ts
 var ConnectorClientError = class _ConnectorClientError extends Error {
@@ -270,8 +251,7 @@ import fs from "fs";
 import https from "https";
 import globalAxios from "axios";
 function buildQueryString(params) {
-  if (!params)
-    return "";
+  if (!params) return "";
   return Object.entries(params).map(stringifyKeyValuePair).join("&");
 }
 function stringifyKeyValuePair([key, value]) {
@@ -339,8 +319,7 @@ var assertParamExists = function(functionName, paramName, paramValue) {
   }
 };
 function setFlattenedQueryParams(urlSearchParams, parameter, key = "") {
-  if (parameter == null)
-    return;
+  if (parameter == null) return;
   if (typeof parameter === "object") {
     if (Array.isArray(parameter)) {
       parameter.forEach((item) => setFlattenedQueryParams(urlSearchParams, item, key));
@@ -396,6 +375,7 @@ var httpRequestFunction = async function(axiosArgs, configuration) {
   const retries = configuration?.retries ?? 0;
   const backoff = configuration?.backoff ?? 0;
   let attempt = 0;
+  let lastError;
   while (attempt <= retries) {
     try {
       const response = await globalAxios.request({
@@ -411,50 +391,59 @@ var httpRequestFunction = async function(axiosArgs, configuration) {
       };
     } catch (error) {
       attempt++;
+      const axiosError = error;
       if (shouldRetryRequest(
-        error,
+        axiosError,
         axiosRequestArgs?.method?.toUpperCase(),
         retries - attempt
       )) {
         await delay(backoff * attempt);
       } else {
-        if (error.response) {
-          const status = error.response?.status;
-          const data = JSON.parse(
-            error.response?.data ?? "{}"
-          );
+        if (axiosError.response && axiosError.response.status) {
+          const status = axiosError.response?.status;
+          const responseData = axiosError.response.data;
+          let data = {};
+          if (responseData && responseData !== null) {
+            if (typeof responseData === "string" && responseData !== "")
+              data = JSON.parse(responseData);
+            else if (typeof responseData === "object")
+              data = responseData;
+          }
+          const errorMsg = data.msg;
           switch (status) {
             case 400:
-              throw new BadRequestError(data?.msg);
+              throw new BadRequestError(errorMsg);
             case 401:
-              throw new UnauthorizedError(data?.msg);
+              throw new UnauthorizedError(errorMsg);
             case 403:
-              throw new ForbiddenError(data?.msg);
+              throw new ForbiddenError(errorMsg);
             case 404:
-              throw new NotFoundError(data?.msg);
+              throw new NotFoundError(errorMsg);
             case 418:
-              throw new RateLimitBanError(data?.msg);
+              throw new RateLimitBanError(errorMsg);
             case 429:
-              throw new TooManyRequestsError(data?.msg);
+              throw new TooManyRequestsError(errorMsg);
             default:
               if (status >= 500 && status < 600)
                 throw new ServerError(`Server error: ${status}`, status);
-              throw new ConnectorClientError(data?.msg);
+              throw new ConnectorClientError(errorMsg);
           }
         } else {
-          throw new NetworkError("Network error or request timeout.");
+          if (retries > 0 && attempt >= retries)
+            lastError = new Error(`Request failed after ${retries} retries`);
+          else lastError = new NetworkError("Network error or request timeout.");
+          break;
         }
       }
     }
   }
-  throw new Error(`Request failed after ${retries} retries`);
+  throw lastError;
 };
 var parseRateLimitHeaders = function(headers) {
   const rateLimits = [];
   const parseIntervalDetails = (key) => {
     const match = key.match(/x-mbx-used-weight-(\d+)([smhd])|x-mbx-order-count-(\d+)([smhd])/i);
-    if (!match)
-      return null;
+    if (!match) return null;
     const intervalNum = parseInt(match[1] || match[3], 10);
     const intervalLetter = (match[2] || match[4])?.toUpperCase();
     let interval;
@@ -478,8 +467,7 @@ var parseRateLimitHeaders = function(headers) {
   };
   for (const [key, value] of Object.entries(headers)) {
     const normalizedKey = key.toLowerCase();
-    if (value === void 0)
-      continue;
+    if (value === void 0) continue;
     if (normalizedKey.startsWith("x-mbx-used-weight-")) {
       const details = parseIntervalDetails(normalizedKey);
       if (details) {
@@ -542,8 +530,7 @@ var sendRequest = function(configuration, endpoint, method, params = {}, timeUni
   );
 };
 function removeEmptyValue(obj) {
-  if (!(obj instanceof Object))
-    return {};
+  if (!(obj instanceof Object)) return {};
   return Object.fromEntries(
     Object.entries(obj).filter(
       ([, value]) => value !== null && value !== void 0 && value !== ""
@@ -559,12 +546,13 @@ function sortObject(obj) {
 function replaceWebsocketStreamsPlaceholders(str, variables) {
   const normalizedVariables = Object.keys(variables).reduce(
     (acc, key) => {
-      acc[key.toLowerCase().replace(/[-_]/g, "")] = variables[key];
+      const normalizedKey = key.toLowerCase().replace(/[-_]/g, "");
+      acc[normalizedKey] = variables[key];
       return acc;
     },
     {}
   );
-  return str.replace(/<([^>]+)>/g, (match, fieldName) => {
+  return str.replace(/(@)?<([^>]+)>/g, (match, precedingAt, fieldName) => {
     const normalizedFieldName = fieldName.toLowerCase().replace(/[-_]/g, "");
     if (Object.prototype.hasOwnProperty.call(normalizedVariables, normalizedFieldName) && normalizedVariables[normalizedFieldName] != null) {
       const value = normalizedVariables[normalizedFieldName];
@@ -575,7 +563,7 @@ function replaceWebsocketStreamsPlaceholders(str, variables) {
         case "updatespeed":
           return `@${value}`;
         default:
-          return value;
+          return (precedingAt || "") + value;
       }
     }
     return "";
@@ -621,7 +609,7 @@ var WebsocketEventEmitter = class {
     this.eventEmitter.emit(event, ...args);
   }
 };
-var _WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
+var WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
   constructor(configuration, connectionPool = []) {
     super();
     this.configuration = configuration;
@@ -633,8 +621,10 @@ var _WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
     this.connectionPool = connectionPool;
     this.mode = this.configuration?.mode ?? "single";
     this.poolSize = this.mode === "pool" && this.configuration?.poolSize ? this.configuration.poolSize : 1;
-    if (!connectionPool || connectionPool.length === 0)
-      this.initializePool(this.poolSize);
+    if (!connectionPool || connectionPool.length === 0) this.initializePool(this.poolSize);
+  }
+  static {
+    this.MAX_CONNECTION_DURATION = 23 * 60 * 60 * 1e3;
   }
   /**
    * Initializes the WebSocket connection pool by creating a specified number of connection objects
@@ -666,8 +656,7 @@ var _WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
    * @returns {WebsocketConnection} The selected WebSocket connection.
    */
   getConnection(allowNonEstablishedWebsockets = false) {
-    if (this.mode === "single")
-      return this.connectionPool[0];
+    if (this.mode === "single") return this.connectionPool[0];
     const availableConnections = this.connectionPool.filter(
       (connection) => this.isConnectionReady(connection, allowNonEstablishedWebsockets)
     );
@@ -712,10 +701,8 @@ var _WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
     const timers = this.connectionTimers.get(connection);
     if (timers) {
       timers.forEach(({ timer, type }) => {
-        if (type === "timeout")
-          clearTimeout(timer);
-        else if (type === "interval")
-          clearInterval(timer);
+        if (type === "timeout") clearTimeout(timer);
+        else if (type === "interval") clearInterval(timer);
       });
       this.connectionTimers.delete(connection);
     }
@@ -731,8 +718,7 @@ var _WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
    * @returns A Promise that resolves when the queue has been fully processed.
    */
   async processQueue(throttleRate = 1e3) {
-    if (this.queueProcessing)
-      return;
+    if (this.queueProcessing) return;
     this.queueProcessing = true;
     while (this.connectionQueue.length > 0) {
       const { connection, url, isRenewal } = this.connectionQueue.shift();
@@ -765,8 +751,7 @@ var _WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
    * @returns Promise that resolves when the connection is closed.
    */
   async closeConnectionGracefully(WebsocketConnectionToClose, connection) {
-    if (!WebsocketConnectionToClose || !connection)
-      return;
+    if (!WebsocketConnectionToClose || !connection) return;
     this.logger.debug("Waiting for pending requests to complete before disconnecting.");
     const closePromise = new Promise((resolve) => {
       this.scheduleTimer(
@@ -899,10 +884,8 @@ var _WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
     this.logger.info(
       `Establishing Websocket connection with id ${targetConnection.id} to: ${url}`
     );
-    if (isRenewal)
-      targetConnection.renewalPending = true;
-    else
-      targetConnection.ws = ws;
+    if (isRenewal) targetConnection.renewalPending = true;
+    else targetConnection.ws = ws;
     this.scheduleTimer(
       ws,
       () => {
@@ -917,8 +900,7 @@ var _WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
     );
     ws.on("open", () => {
       const oldWSConnection = targetConnection.ws;
-      if (targetConnection.renewalPending)
-        targetConnection.ws = ws;
+      if (targetConnection.renewalPending) targetConnection.ws = ws;
       this.onOpen(url, targetConnection, oldWSConnection);
     });
     ws.on("message", (data) => {
@@ -982,8 +964,7 @@ var _WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
    * @throws Error if the WebSocket client is not set.
    */
   async disconnect() {
-    if (!this.isConnected())
-      this.logger.warn("No connection to close.");
+    if (!this.isConnected()) this.logger.warn("No connection to close.");
     else {
       this.connectionPool.forEach((connection) => {
         connection.closeInitiated = true;
@@ -1033,25 +1014,20 @@ var _WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
     if (!this.isConnected(connection)) {
       const errorMsg = "Send can only be sent when connection is ready.";
       this.logger.warn(errorMsg);
-      if (promiseBased)
-        return Promise.reject(new Error(errorMsg));
-      else
-        throw new Error(errorMsg);
+      if (promiseBased) return Promise.reject(new Error(errorMsg));
+      else throw new Error(errorMsg);
     }
     const connectionToUse = connection ?? this.getConnection();
     if (!connectionToUse.ws) {
       const errorMsg = "Websocket Client not set";
       this.logger.error(errorMsg);
-      if (promiseBased)
-        return Promise.reject(new Error(errorMsg));
-      else
-        throw new Error(errorMsg);
+      if (promiseBased) return Promise.reject(new Error(errorMsg));
+      else throw new Error(errorMsg);
     }
     connectionToUse.ws.send(payload);
     if (promiseBased) {
       return new Promise((resolve, reject) => {
-        if (!id)
-          return reject(new Error("id is required for promise-based sending."));
+        if (!id) return reject(new Error("id is required for promise-based sending."));
         connectionToUse.pendingRequests.set(id, { resolve, reject });
         this.scheduleTimer(
           connectionToUse.ws,
@@ -1067,8 +1043,6 @@ var _WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
     }
   }
 };
-_WebsocketCommon.MAX_CONNECTION_DURATION = 23 * 60 * 60 * 1e3;
-var WebsocketCommon = _WebsocketCommon;
 var WebsocketAPIBase = class extends WebsocketCommon {
   constructor(configuration, connectionPool = []) {
     super(configuration, connectionPool);
@@ -1108,8 +1082,7 @@ var WebsocketAPIBase = class extends WebsocketCommon {
           request?.reject(message.error);
         } else {
           const response = { data: message.result };
-          if (message?.rateLimits)
-            response.rateLimits = message.rateLimits;
+          if (message?.rateLimits) response.rateLimits = message.rateLimits;
           request?.resolve(response);
         }
       } else {
@@ -1131,8 +1104,7 @@ var WebsocketAPIBase = class extends WebsocketCommon {
       return Promise.resolve();
     }
     return new Promise((resolve, reject) => {
-      if (this.isConnecting)
-        return;
+      if (this.isConnecting) return;
       this.isConnecting = true;
       const timeout = setTimeout(() => {
         this.isConnecting = false;
@@ -1228,15 +1200,13 @@ var WebsocketStreamsBase2 = class extends WebsocketCommon {
   handleStreamAssignment(streams) {
     const connectionStreamMap = /* @__PURE__ */ new Map();
     streams.forEach((stream) => {
-      if (!this.streamCallbackMap.has(stream))
-        this.streamCallbackMap.set(stream, /* @__PURE__ */ new Set());
+      if (!this.streamCallbackMap.has(stream)) this.streamCallbackMap.set(stream, /* @__PURE__ */ new Set());
       let connection = this.streamConnectionMap.get(stream);
       if (!connection || connection.closeInitiated || connection.reconnectionPending) {
         connection = this.getConnection(true);
         this.streamConnectionMap.set(stream, connection);
       }
-      if (!connectionStreamMap.has(connection))
-        connectionStreamMap.set(connection, []);
+      if (!connectionStreamMap.has(connection)) connectionStreamMap.set(connection, []);
       connectionStreamMap.get(connection)?.push(stream);
     });
     return connectionStreamMap;
@@ -1392,18 +1362,12 @@ var WebsocketStreamsBase2 = class extends WebsocketCommon {
 };
 export {
   ALGO_REST_API_PROD_URL,
-  ALGO_REST_API_TESTNET_URL,
   AUTO_INVEST_REST_API_PROD_URL,
-  AUTO_INVEST_REST_API_TESTNET_URL,
   BadRequestError,
   C2C_REST_API_PROD_URL,
-  C2C_REST_API_TESTNET_URL,
   CONVERT_REST_API_PROD_URL,
-  CONVERT_REST_API_TESTNET_URL,
   COPY_TRADING_REST_API_PROD_URL,
-  COPY_TRADING_REST_API_TESTNET_URL,
   CRYPTO_LOAN_REST_API_PROD_URL,
-  CRYPTO_LOAN_REST_API_TESTNET_URL,
   ConfigurationRestAPI,
   ConfigurationWebsocketAPI,
   ConfigurationWebsocketStreams,
@@ -1427,30 +1391,21 @@ export {
   DERIVATIVES_TRADING_USDS_FUTURES_WS_STREAMS_PROD_URL,
   DERIVATIVES_TRADING_USDS_FUTURES_WS_STREAMS_TESTNET_URL,
   DUAL_INVESTMENT_REST_API_PROD_URL,
-  DUAL_INVESTMENT_REST_API_TESTNET_URL,
   FIAT_REST_API_PROD_URL,
-  FIAT_REST_API_TESTNET_URL,
   ForbiddenError,
   GIFT_CARD_REST_API_PROD_URL,
-  GIFT_CARD_REST_API_TESTNET_URL,
   LogLevel,
   Logger,
   MARGIN_TRADING_REST_API_PROD_URL,
-  MARGIN_TRADING_REST_API_TESTNET_URL,
   MINING_REST_API_PROD_URL,
-  MINING_REST_API_TESTNET_URL,
   NFT_REST_API_PROD_URL,
-  NFT_REST_API_TESTNET_URL,
   NetworkError,
   NotFoundError,
   PAY_REST_API_PROD_URL,
-  PAY_REST_API_TESTNET_URL,
   REBATE_REST_API_PROD_URL,
-  REBATE_REST_API_TESTNET_URL,
   RateLimitBanError,
   RequiredError,
   SIMPLE_EARN_REST_API_PROD_URL,
-  SIMPLE_EARN_REST_API_TESTNET_URL,
   SPOT_REST_API_MARKET_URL,
   SPOT_REST_API_PROD_URL,
   SPOT_REST_API_TESTNET_URL,
@@ -1460,17 +1415,13 @@ export {
   SPOT_WS_STREAMS_PROD_URL,
   SPOT_WS_STREAMS_TESTNET_URL,
   STAKING_REST_API_PROD_URL,
-  STAKING_REST_API_TESTNET_URL,
   SUB_ACCOUNT_REST_API_PROD_URL,
-  SUB_ACCOUNT_REST_API_TESTNET_URL,
   ServerError,
   TimeUnit,
   TooManyRequestsError,
   UnauthorizedError,
   VIP_LOAN_REST_API_PROD_URL,
-  VIP_LOAN_REST_API_TESTNET_URL,
   WALLET_REST_API_PROD_URL,
-  WALLET_REST_API_TESTNET_URL,
   WebsocketAPIBase,
   WebsocketCommon,
   WebsocketEventEmitter,