fix(types): add runtime enum exports, WebSocket types, and futuresOrder algo response (#696)

- Add runtime exports for OrderSide, OrderType, TimeInForce, OrderStatus,
  RateLimitType, RateLimitInterval, TradingType so enum values work at runtime
- Add types/websocket.d.ts with event interfaces and BinanceWebSocket interface
- Add ws property to BinanceRest and export websocket types from index.d.ts
- Add FuturesAlgoOrderResponse type and union return for futuresOrder
- Add missing futuresOrder payload fields (triggerPrice, positionSide, etc.)
- Add top-level "types" field to package.json for older TS moduleResolution

Author: pcriadoperez

index.d.ts

@@ -12,6 +12,7 @@ import { PortfolioMarginEndpoints } from './types/portfolio-margin';
 import { SavingsEndpoints } from './types/savings';
 import { MiningEndpoints } from './types/mining';
 import { UtilityEndpoints } from './types/utility';
+import { BinanceWebSocket } from './types/websocket';
 
 export interface BinanceRest extends
   GenericEndpoints,
@@ -26,7 +27,9 @@ export interface BinanceRest extends
   PortfolioMarginEndpoints,
   SavingsEndpoints,
   MiningEndpoints,
-  UtilityEndpoints {}
+  UtilityEndpoints {
+  ws: BinanceWebSocket;
+}
 
 export * from './types/base';
 
@@ -143,6 +146,8 @@ export * from './types/utility';
 
 // } from './types/utility';
 
+export * from './types/websocket';
+
 
 declare function Binance(options?: BinanceRestClient.BinanceRestOptions): BinanceRest;
 export default Binance;

package.json

@@ -3,6 +3,7 @@
   "version": "0.13.6",
   "description": "A node API wrapper for Binance",
   "main": "dist",
+  "types": "index.d.ts",
   "browser": {
     "crypto": false,
     "./dist/http-client.js": "./dist/http-client.js"

src/index.js

@@ -118,3 +118,60 @@ export const PayStatus = {
     SUCCESS: 'SUCCESS',
     FAILED: 'FAILED',
 }
+
+export const OrderSide = {
+    BUY: 'BUY',
+    SELL: 'SELL',
+}
+
+export const OrderType = {
+    LIMIT: 'LIMIT',
+    MARKET: 'MARKET',
+    STOP_LOSS: 'STOP_LOSS',
+    STOP_LOSS_LIMIT: 'STOP_LOSS_LIMIT',
+    TAKE_PROFIT: 'TAKE_PROFIT',
+    TAKE_PROFIT_LIMIT: 'TAKE_PROFIT_LIMIT',
+    LIMIT_MAKER: 'LIMIT_MAKER',
+    STOP_MARKET: 'STOP_MARKET',
+    TAKE_PROFIT_MARKET: 'TAKE_PROFIT_MARKET',
+    TRAILING_STOP_MARKET: 'TRAILING_STOP_MARKET',
+}
+
+export const TimeInForce = {
+    GTC: 'GTC',
+    IOC: 'IOC',
+    FOK: 'FOK',
+    RPI: 'RPI',
+}
+
+export const OrderStatus = {
+    NEW: 'NEW',
+    PARTIALLY_FILLED: 'PARTIALLY_FILLED',
+    FILLED: 'FILLED',
+    CANCELED: 'CANCELED',
+    PENDING_CANCEL: 'PENDING_CANCEL',
+    REJECTED: 'REJECTED',
+    EXPIRED: 'EXPIRED',
+    ACCEPTED: 'ACCEPTED',
+    TRIGGERING: 'TRIGGERING',
+    TRIGGERED: 'TRIGGERED',
+    FINISHED: 'FINISHED',
+}
+
+export const RateLimitType = {
+    REQUEST_WEIGHT: 'REQUEST_WEIGHT',
+    ORDERS: 'ORDERS',
+    RAW_REQUESTS: 'RAW_REQUESTS',
+}
+
+export const RateLimitInterval = {
+    SECOND: 'SECOND',
+    MINUTE: 'MINUTE',
+    HOUR: 'HOUR',
+    DAY: 'DAY',
+}
+
+export const TradingType = {
+    SPOT: 'SPOT',
+    MARGIN: 'MARGIN',
+}

types/futures.d.ts

@@ -1,5 +1,40 @@
 import { BinanceRestClient, OrderSide, OrderStatus, OrderType, TimeInForce } from './base';
 
+export interface FuturesOrderResponse {
+  symbol: string;
+  orderId: number;
+  orderListId: number;
+  clientOrderId: string;
+  transactTime: number;
+  price: string;
+  origQty: string;
+  executedQty: string;
+  cumQuote: string;
+  status: OrderStatus;
+  timeInForce: TimeInForce;
+  type: OrderType;
+  side: OrderSide;
+  marginBuyBorrowAmount: string;
+  marginBuyBorrowAsset: string;
+  fills: Array<{
+    price: string;
+    qty: string;
+    commission: string;
+    commissionAsset: string;
+  }>;
+}
+
+export interface FuturesAlgoOrderResponse {
+  symbol: string;
+  algoId: number;
+  clientAlgoId: string;
+  transactTime: number;
+  algoType: string;
+  side: OrderSide;
+  type: string;
+  status: OrderStatus;
+}
+
 export interface FuturesEndpoints extends BinanceRestClient {
   futuresPing(): Promise<boolean>;
   futuresTime(): Promise<{
@@ -156,34 +191,21 @@ export interface FuturesEndpoints extends BinanceRestClient {
     price?: string;
     newClientOrderId?: string;
     stopPrice?: string;
+    triggerPrice?: string;
     trailingDelta?: number;
     trailingTime?: number;
     icebergQty?: string;
     newOrderRespType?: string;
     timeInForce?: TimeInForce;
-  }): Promise<{
-    symbol: string;
-    orderId: number;
-    orderListId: number;
-    clientOrderId: string;
-    transactTime: number;
-    price: string;
-    origQty: string;
-    executedQty: string;
-    cumQuote: string;
-    status: OrderStatus;
-    timeInForce: TimeInForce;
-    type: OrderType;
-    side: OrderSide;
-    marginBuyBorrowAmount: string;
-    marginBuyBorrowAsset: string;
-    fills: Array<{
-      price: string;
-      qty: string;
-      commission: string;
-      commissionAsset: string;
-    }>;
-  }>;
+    positionSide?: 'BOTH' | 'LONG' | 'SHORT';
+    reduceOnly?: string;
+    closePosition?: boolean;
+    workingType?: 'MARK_PRICE' | 'CONTRACT_PRICE';
+    priceProtect?: string;
+    activationPrice?: string;
+    callbackRate?: string;
+    clientAlgoId?: string;
+  }): Promise<FuturesOrderResponse | FuturesAlgoOrderResponse>;
   futuresUpdateOrder(payload: {
     orderId?: number;
     origClientOrderId?: string;