@alpha-arcade/sdk 0.3.1 → 0.4.1

package/dist/index.d.cts

@@ -362,6 +362,76 @@ type EscrowGlobalState = {
     asset_listed?: number;
     fee_timer_start?: number;
 };
+/** Configuration for AlphaWebSocket */
+type AlphaWebSocketConfig = {
+    /** WebSocket URL override (default: wss://wss.platform.alphaarcade.com) */
+    url?: string;
+    /** Enable auto-reconnect on unexpected disconnect (default: true) */
+    reconnect?: boolean;
+    /** Maximum reconnect attempts before giving up (default: Infinity) */
+    maxReconnectAttempts?: number;
+    /** Heartbeat interval in ms (default: 60000) */
+    heartbeatIntervalMs?: number;
+    /**
+     * WebSocket constructor to use. Defaults to the global `WebSocket`.
+     * On Node.js < 22, pass the `ws` package: `import WebSocket from 'ws'; new AlphaWebSocket({ WebSocket })`
+     */
+    WebSocket?: unknown;
+};
+/** Orderbook bid/ask entry at the top level (decimal cents) */
+type WsOrderbookAggregatedEntry = {
+    price: number;
+    quantity: number;
+    total: number;
+};
+/** Orderbook bid/ask entry with escrow details (raw microunit prices) */
+type WsOrderbookDetailEntry = {
+    price: number;
+    quantity: number;
+    total: number;
+    escrowAppId: number;
+    owner: string;
+};
+/** Per-side orderbook detail (yes or no) */
+type WsOrderbookDetailSide = {
+    bids: WsOrderbookDetailEntry[];
+    asks: WsOrderbookDetailEntry[];
+};
+/** Orderbook data for a single app within the orderbook payload */
+type WsOrderbookApp = {
+    bids: WsOrderbookAggregatedEntry[];
+    asks: WsOrderbookAggregatedEntry[];
+    spread: number;
+    yes: WsOrderbookDetailSide;
+    no: WsOrderbookDetailSide;
+};
+/** Payload for orderbook_changed events */
+type OrderbookChangedEvent = {
+    type: 'orderbook_changed';
+    ts: number;
+    marketId: string;
+    orderbook: Record<string, WsOrderbookApp>;
+};
+/** Payload for markets_changed events (incremental diffs) */
+type MarketsChangedEvent = {
+    type: 'markets_changed';
+    ts: number;
+    [key: string]: unknown;
+};
+/** Payload for market_changed events (single market) */
+type MarketChangedEvent = {
+    type: 'market_changed';
+    ts: number;
+    [key: string]: unknown;
+};
+/** Payload for wallet_orders_changed events */
+type WalletOrdersChangedEvent = {
+    type: 'wallet_orders_changed';
+    ts: number;
+    [key: string]: unknown;
+};
+/** Discriminated union of all WebSocket stream events */
+type WebSocketStreamEvent = MarketsChangedEvent | MarketChangedEvent | OrderbookChangedEvent | WalletOrdersChangedEvent;
 
 /**
  * The main client for interacting with Alpha Market prediction markets on Algorand.
@@ -597,6 +667,93 @@ declare class AlphaClient {
     getMarketFromApi(marketId: string): Promise<Market | null>;
 }
 
+/**
+ * Real-time WebSocket client for Alpha Market platform streams.
+ *
+ * Connects to `wss://wss.platform.alphaarcade.com` and provides typed,
+ * callback-based subscriptions for live market data. No auth required.
+ *
+ * @example
+ * ```typescript
+ * // Node.js 22+ or browser (native WebSocket)
+ * const ws = new AlphaWebSocket();
+ *
+ * // Node.js < 22 — pass the `ws` package
+ * import WebSocket from 'ws';
+ * const ws = new AlphaWebSocket({ WebSocket });
+ *
+ * const unsub = ws.subscribeOrderbook('will-btc-hit-100k', (event) => {
+ *   console.log('Orderbook:', event.orderbook);
+ * });
+ *
+ * // Later
+ * unsub();
+ * ws.close();
+ * ```
+ */
+declare class AlphaWebSocket {
+    private url;
+    private reconnectEnabled;
+    private maxReconnectAttempts;
+    private heartbeatIntervalMs;
+    private WebSocketImpl;
+    private ws;
+    private subscriptions;
+    private pendingRequests;
+    private heartbeatTimer;
+    private reconnectTimer;
+    private reconnectAttempts;
+    private intentionallyClosed;
+    private connectPromise;
+    constructor(config?: AlphaWebSocketConfig);
+    /** Whether the WebSocket is currently open and connected */
+    get connected(): boolean;
+    /**
+     * Subscribe to live market probability updates (incremental diffs).
+     * @returns An unsubscribe function
+     */
+    subscribeLiveMarkets(callback: (event: MarketsChangedEvent) => void): () => void;
+    /**
+     * Subscribe to change events for a single market.
+     * @param slug - The market slug
+     * @returns An unsubscribe function
+     */
+    subscribeMarket(slug: string, callback: (event: MarketChangedEvent) => void): () => void;
+    /**
+     * Subscribe to full orderbook snapshots (~5s interval on changes).
+     * @param slug - The market slug
+     * @returns An unsubscribe function
+     */
+    subscribeOrderbook(slug: string, callback: (event: OrderbookChangedEvent) => void): () => void;
+    /**
+     * Subscribe to wallet order updates.
+     * @param wallet - The wallet address
+     * @returns An unsubscribe function
+     */
+    subscribeWalletOrders(wallet: string, callback: (event: WalletOrdersChangedEvent) => void): () => void;
+    /** Query the server for the list of active subscriptions on this connection */
+    listSubscriptions(): Promise<unknown>;
+    /** Query a server property (e.g. "heartbeat", "limits") */
+    getProperty(property: string): Promise<unknown>;
+    /** Open the WebSocket connection. Called automatically on first subscribe. */
+    connect(): Promise<void>;
+    /** Close the connection and clean up all resources */
+    close(): void;
+    private buildStreamKey;
+    private buildQueryString;
+    private subscribe;
+    private doConnect;
+    private handleMessage;
+    private sendSubscribe;
+    private sendUnsubscribe;
+    private sendRequest;
+    private send;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private scheduleReconnect;
+    private clearTimers;
+}
+
 /**
  * Fetches all live, tradeable markets directly from the Algorand blockchain.
  *
@@ -639,6 +796,7 @@ declare const getLiveMarketsFromApi: (config: AlphaClientConfig) => Promise<Mark
 declare const getMarketFromApi: (config: AlphaClientConfig, marketId: string) => Promise<Market | null>;
 
 declare const DEFAULT_API_BASE_URL = "https://platform.alphaarcade.com/api";
+declare const DEFAULT_WSS_BASE_URL = "wss://wss.platform.alphaarcade.com";
 declare const DEFAULT_MARKET_CREATOR_ADDRESS = "5P5Y6HTWUNG2E3VXBQDZN3ENZD3JPAIR5PKT3LOYJAPAUKOLFD6KANYTRY";
 
 /**
@@ -720,4 +878,4 @@ declare const getEscrowGlobalState: (indexerClient: algosdk.Indexer, escrowAppId
  */
 declare const checkAssetOptIn: (algodClient: algosdk.Algodv2, address: string, assetId: number) => Promise<boolean>;
 
-export { type AggregatedOrderbook, type AggregatedOrderbookEntry, type AggregatedOrderbookSide, AlphaClient, type AlphaClientConfig, type AmendOrderParams, type AmendOrderResult, type CancelOrderParams, type CancelOrderResult, type ClaimParams, type ClaimResult, type CounterpartyMatch, type CreateLimitOrderParams, type CreateMarketOrderParams, type CreateOrderResult, DEFAULT_API_BASE_URL, DEFAULT_MARKET_CREATOR_ADDRESS, type EscrowGlobalState, type Market, type MarketGlobalState, type MarketOption, type MergeSharesParams, type OpenOrder, type OrderSide, type Orderbook, type OrderbookEntry, type OrderbookSide, type Position, type ProcessMatchParams, type ProcessMatchResult, type ProposeMatchParams, type ProposeMatchResult, type SplitMergeResult, type SplitSharesParams, type WalletPosition, calculateFee, calculateFeeFromTotal, calculateMatchingOrders, checkAssetOptIn, decodeGlobalState, getEscrowGlobalState, getLiveMarketsFromApi, getMarketFromApi, getMarketGlobalState, getMarketOnChain, getMarketsOnChain };
+export { type AggregatedOrderbook, type AggregatedOrderbookEntry, type AggregatedOrderbookSide, AlphaClient, type AlphaClientConfig, AlphaWebSocket, type AlphaWebSocketConfig, type AmendOrderParams, type AmendOrderResult, type CancelOrderParams, type CancelOrderResult, type ClaimParams, type ClaimResult, type CounterpartyMatch, type CreateLimitOrderParams, type CreateMarketOrderParams, type CreateOrderResult, DEFAULT_API_BASE_URL, DEFAULT_MARKET_CREATOR_ADDRESS, DEFAULT_WSS_BASE_URL, type EscrowGlobalState, type Market, type MarketChangedEvent, type MarketGlobalState, type MarketOption, type MarketsChangedEvent, type MergeSharesParams, type OpenOrder, type OrderSide, type Orderbook, type OrderbookChangedEvent, type OrderbookEntry, type OrderbookSide, type Position, type ProcessMatchParams, type ProcessMatchResult, type ProposeMatchParams, type ProposeMatchResult, type SplitMergeResult, type SplitSharesParams, type WalletOrdersChangedEvent, type WalletPosition, type WebSocketStreamEvent, type WsOrderbookAggregatedEntry, type WsOrderbookApp, type WsOrderbookDetailEntry, type WsOrderbookDetailSide, calculateFee, calculateFeeFromTotal, calculateMatchingOrders, checkAssetOptIn, decodeGlobalState, getEscrowGlobalState, getLiveMarketsFromApi, getMarketFromApi, getMarketGlobalState, getMarketOnChain, getMarketsOnChain };

package/dist/index.d.ts

@@ -362,6 +362,76 @@ type EscrowGlobalState = {
     asset_listed?: number;
     fee_timer_start?: number;
 };
+/** Configuration for AlphaWebSocket */
+type AlphaWebSocketConfig = {
+    /** WebSocket URL override (default: wss://wss.platform.alphaarcade.com) */
+    url?: string;
+    /** Enable auto-reconnect on unexpected disconnect (default: true) */
+    reconnect?: boolean;
+    /** Maximum reconnect attempts before giving up (default: Infinity) */
+    maxReconnectAttempts?: number;
+    /** Heartbeat interval in ms (default: 60000) */
+    heartbeatIntervalMs?: number;
+    /**
+     * WebSocket constructor to use. Defaults to the global `WebSocket`.
+     * On Node.js < 22, pass the `ws` package: `import WebSocket from 'ws'; new AlphaWebSocket({ WebSocket })`
+     */
+    WebSocket?: unknown;
+};
+/** Orderbook bid/ask entry at the top level (decimal cents) */
+type WsOrderbookAggregatedEntry = {
+    price: number;
+    quantity: number;
+    total: number;
+};
+/** Orderbook bid/ask entry with escrow details (raw microunit prices) */
+type WsOrderbookDetailEntry = {
+    price: number;
+    quantity: number;
+    total: number;
+    escrowAppId: number;
+    owner: string;
+};
+/** Per-side orderbook detail (yes or no) */
+type WsOrderbookDetailSide = {
+    bids: WsOrderbookDetailEntry[];
+    asks: WsOrderbookDetailEntry[];
+};
+/** Orderbook data for a single app within the orderbook payload */
+type WsOrderbookApp = {
+    bids: WsOrderbookAggregatedEntry[];
+    asks: WsOrderbookAggregatedEntry[];
+    spread: number;
+    yes: WsOrderbookDetailSide;
+    no: WsOrderbookDetailSide;
+};
+/** Payload for orderbook_changed events */
+type OrderbookChangedEvent = {
+    type: 'orderbook_changed';
+    ts: number;
+    marketId: string;
+    orderbook: Record<string, WsOrderbookApp>;
+};
+/** Payload for markets_changed events (incremental diffs) */
+type MarketsChangedEvent = {
+    type: 'markets_changed';
+    ts: number;
+    [key: string]: unknown;
+};
+/** Payload for market_changed events (single market) */
+type MarketChangedEvent = {
+    type: 'market_changed';
+    ts: number;
+    [key: string]: unknown;
+};
+/** Payload for wallet_orders_changed events */
+type WalletOrdersChangedEvent = {
+    type: 'wallet_orders_changed';
+    ts: number;
+    [key: string]: unknown;
+};
+/** Discriminated union of all WebSocket stream events */
+type WebSocketStreamEvent = MarketsChangedEvent | MarketChangedEvent | OrderbookChangedEvent | WalletOrdersChangedEvent;
 
 /**
  * The main client for interacting with Alpha Market prediction markets on Algorand.
@@ -597,6 +667,93 @@ declare class AlphaClient {
     getMarketFromApi(marketId: string): Promise<Market | null>;
 }
 
+/**
+ * Real-time WebSocket client for Alpha Market platform streams.
+ *
+ * Connects to `wss://wss.platform.alphaarcade.com` and provides typed,
+ * callback-based subscriptions for live market data. No auth required.
+ *
+ * @example
+ * ```typescript
+ * // Node.js 22+ or browser (native WebSocket)
+ * const ws = new AlphaWebSocket();
+ *
+ * // Node.js < 22 — pass the `ws` package
+ * import WebSocket from 'ws';
+ * const ws = new AlphaWebSocket({ WebSocket });
+ *
+ * const unsub = ws.subscribeOrderbook('will-btc-hit-100k', (event) => {
+ *   console.log('Orderbook:', event.orderbook);
+ * });
+ *
+ * // Later
+ * unsub();
+ * ws.close();
+ * ```
+ */
+declare class AlphaWebSocket {
+    private url;
+    private reconnectEnabled;
+    private maxReconnectAttempts;
+    private heartbeatIntervalMs;
+    private WebSocketImpl;
+    private ws;
+    private subscriptions;
+    private pendingRequests;
+    private heartbeatTimer;
+    private reconnectTimer;
+    private reconnectAttempts;
+    private intentionallyClosed;
+    private connectPromise;
+    constructor(config?: AlphaWebSocketConfig);
+    /** Whether the WebSocket is currently open and connected */
+    get connected(): boolean;
+    /**
+     * Subscribe to live market probability updates (incremental diffs).
+     * @returns An unsubscribe function
+     */
+    subscribeLiveMarkets(callback: (event: MarketsChangedEvent) => void): () => void;
+    /**
+     * Subscribe to change events for a single market.
+     * @param slug - The market slug
+     * @returns An unsubscribe function
+     */
+    subscribeMarket(slug: string, callback: (event: MarketChangedEvent) => void): () => void;
+    /**
+     * Subscribe to full orderbook snapshots (~5s interval on changes).
+     * @param slug - The market slug
+     * @returns An unsubscribe function
+     */
+    subscribeOrderbook(slug: string, callback: (event: OrderbookChangedEvent) => void): () => void;
+    /**
+     * Subscribe to wallet order updates.
+     * @param wallet - The wallet address
+     * @returns An unsubscribe function
+     */
+    subscribeWalletOrders(wallet: string, callback: (event: WalletOrdersChangedEvent) => void): () => void;
+    /** Query the server for the list of active subscriptions on this connection */
+    listSubscriptions(): Promise<unknown>;
+    /** Query a server property (e.g. "heartbeat", "limits") */
+    getProperty(property: string): Promise<unknown>;
+    /** Open the WebSocket connection. Called automatically on first subscribe. */
+    connect(): Promise<void>;
+    /** Close the connection and clean up all resources */
+    close(): void;
+    private buildStreamKey;
+    private buildQueryString;
+    private subscribe;
+    private doConnect;
+    private handleMessage;
+    private sendSubscribe;
+    private sendUnsubscribe;
+    private sendRequest;
+    private send;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private scheduleReconnect;
+    private clearTimers;
+}
+
 /**
  * Fetches all live, tradeable markets directly from the Algorand blockchain.
  *
@@ -639,6 +796,7 @@ declare const getLiveMarketsFromApi: (config: AlphaClientConfig) => Promise<Mark
 declare const getMarketFromApi: (config: AlphaClientConfig, marketId: string) => Promise<Market | null>;
 
 declare const DEFAULT_API_BASE_URL = "https://platform.alphaarcade.com/api";
+declare const DEFAULT_WSS_BASE_URL = "wss://wss.platform.alphaarcade.com";
 declare const DEFAULT_MARKET_CREATOR_ADDRESS = "5P5Y6HTWUNG2E3VXBQDZN3ENZD3JPAIR5PKT3LOYJAPAUKOLFD6KANYTRY";
 
 /**
@@ -720,4 +878,4 @@ declare const getEscrowGlobalState: (indexerClient: algosdk.Indexer, escrowAppId
  */
 declare const checkAssetOptIn: (algodClient: algosdk.Algodv2, address: string, assetId: number) => Promise<boolean>;
 
-export { type AggregatedOrderbook, type AggregatedOrderbookEntry, type AggregatedOrderbookSide, AlphaClient, type AlphaClientConfig, type AmendOrderParams, type AmendOrderResult, type CancelOrderParams, type CancelOrderResult, type ClaimParams, type ClaimResult, type CounterpartyMatch, type CreateLimitOrderParams, type CreateMarketOrderParams, type CreateOrderResult, DEFAULT_API_BASE_URL, DEFAULT_MARKET_CREATOR_ADDRESS, type EscrowGlobalState, type Market, type MarketGlobalState, type MarketOption, type MergeSharesParams, type OpenOrder, type OrderSide, type Orderbook, type OrderbookEntry, type OrderbookSide, type Position, type ProcessMatchParams, type ProcessMatchResult, type ProposeMatchParams, type ProposeMatchResult, type SplitMergeResult, type SplitSharesParams, type WalletPosition, calculateFee, calculateFeeFromTotal, calculateMatchingOrders, checkAssetOptIn, decodeGlobalState, getEscrowGlobalState, getLiveMarketsFromApi, getMarketFromApi, getMarketGlobalState, getMarketOnChain, getMarketsOnChain };
+export { type AggregatedOrderbook, type AggregatedOrderbookEntry, type AggregatedOrderbookSide, AlphaClient, type AlphaClientConfig, AlphaWebSocket, type AlphaWebSocketConfig, type AmendOrderParams, type AmendOrderResult, type CancelOrderParams, type CancelOrderResult, type ClaimParams, type ClaimResult, type CounterpartyMatch, type CreateLimitOrderParams, type CreateMarketOrderParams, type CreateOrderResult, DEFAULT_API_BASE_URL, DEFAULT_MARKET_CREATOR_ADDRESS, DEFAULT_WSS_BASE_URL, type EscrowGlobalState, type Market, type MarketChangedEvent, type MarketGlobalState, type MarketOption, type MarketsChangedEvent, type MergeSharesParams, type OpenOrder, type OrderSide, type Orderbook, type OrderbookChangedEvent, type OrderbookEntry, type OrderbookSide, type Position, type ProcessMatchParams, type ProcessMatchResult, type ProposeMatchParams, type ProposeMatchResult, type SplitMergeResult, type SplitSharesParams, type WalletOrdersChangedEvent, type WalletPosition, type WebSocketStreamEvent, type WsOrderbookAggregatedEntry, type WsOrderbookApp, type WsOrderbookDetailEntry, type WsOrderbookDetailSide, calculateFee, calculateFeeFromTotal, calculateMatchingOrders, checkAssetOptIn, decodeGlobalState, getEscrowGlobalState, getLiveMarketsFromApi, getMarketFromApi, getMarketGlobalState, getMarketOnChain, getMarketsOnChain };

package/dist/index.js

@@ -2103,6 +2103,7 @@ var calculateMatchingOrders = (orderbook, isBuying, isYes, quantity, price, slip
 
 // src/constants.ts
 var DEFAULT_API_BASE_URL = "https://platform.alphaarcade.com/api";
+var DEFAULT_WSS_BASE_URL = "wss://wss.platform.alphaarcade.com";
 var DEFAULT_MARKET_CREATOR_ADDRESS = "5P5Y6HTWUNG2E3VXBQDZN3ENZD3JPAIR5PKT3LOYJAPAUKOLFD6KANYTRY";
 
 // src/modules/orderbook.ts
@@ -3344,6 +3345,270 @@ var AlphaClient = class {
   }
 };
 
-export { AlphaClient, DEFAULT_API_BASE_URL, DEFAULT_MARKET_CREATOR_ADDRESS, calculateFee, calculateFeeFromTotal, calculateMatchingOrders, checkAssetOptIn, decodeGlobalState, getEscrowGlobalState, getLiveMarketsFromApi, getMarketFromApi, getMarketGlobalState, getMarketOnChain, getMarketsOnChain };
+// src/websocket.ts
+var WS_OPEN = 1;
+var resolveWebSocket = (provided) => {
+  if (provided) return provided;
+  if (typeof globalThis !== "undefined" && globalThis.WebSocket) {
+    return globalThis.WebSocket;
+  }
+  throw new Error(
+    'No WebSocket implementation found. On Node.js < 22, install the "ws" package and pass it: new AlphaWebSocket({ WebSocket: require("ws") })'
+  );
+};
+var AlphaWebSocket = class {
+  url;
+  reconnectEnabled;
+  maxReconnectAttempts;
+  heartbeatIntervalMs;
+  WebSocketImpl;
+  ws = null;
+  subscriptions = /* @__PURE__ */ new Map();
+  pendingRequests = /* @__PURE__ */ new Map();
+  heartbeatTimer = null;
+  reconnectTimer = null;
+  reconnectAttempts = 0;
+  intentionallyClosed = false;
+  connectPromise = null;
+  constructor(config) {
+    this.url = config?.url ?? DEFAULT_WSS_BASE_URL;
+    this.reconnectEnabled = config?.reconnect ?? true;
+    this.maxReconnectAttempts = config?.maxReconnectAttempts ?? Infinity;
+    this.heartbeatIntervalMs = config?.heartbeatIntervalMs ?? 6e4;
+    this.WebSocketImpl = resolveWebSocket(config?.WebSocket);
+  }
+  /** Whether the WebSocket is currently open and connected */
+  get connected() {
+    return this.ws?.readyState === WS_OPEN;
+  }
+  // ============================================
+  // Subscribe Methods
+  // ============================================
+  /**
+   * Subscribe to live market probability updates (incremental diffs).
+   * @returns An unsubscribe function
+   */
+  subscribeLiveMarkets(callback) {
+    return this.subscribe("get-live-markets", {}, "markets_changed", callback);
+  }
+  /**
+   * Subscribe to change events for a single market.
+   * @param slug - The market slug
+   * @returns An unsubscribe function
+   */
+  subscribeMarket(slug, callback) {
+    return this.subscribe("get-market", { slug }, "market_changed", callback);
+  }
+  /**
+   * Subscribe to full orderbook snapshots (~5s interval on changes).
+   * @param slug - The market slug
+   * @returns An unsubscribe function
+   */
+  subscribeOrderbook(slug, callback) {
+    return this.subscribe("get-orderbook", { slug }, "orderbook_changed", callback);
+  }
+  /**
+   * Subscribe to wallet order updates.
+   * @param wallet - The wallet address
+   * @returns An unsubscribe function
+   */
+  subscribeWalletOrders(wallet, callback) {
+    return this.subscribe("get-wallet-orders", { wallet }, "wallet_orders_changed", callback);
+  }
+  // ============================================
+  // Control Methods
+  // ============================================
+  /** Query the server for the list of active subscriptions on this connection */
+  listSubscriptions() {
+    return this.sendRequest({ method: "LIST_SUBSCRIPTIONS" });
+  }
+  /** Query a server property (e.g. "heartbeat", "limits") */
+  getProperty(property) {
+    return this.sendRequest({ method: "GET_PROPERTY", params: [property] });
+  }
+  // ============================================
+  // Lifecycle
+  // ============================================
+  /** Open the WebSocket connection. Called automatically on first subscribe. */
+  connect() {
+    if (this.connectPromise) return this.connectPromise;
+    this.connectPromise = this.doConnect();
+    return this.connectPromise;
+  }
+  /** Close the connection and clean up all resources */
+  close() {
+    this.intentionallyClosed = true;
+    this.clearTimers();
+    this.subscriptions.clear();
+    for (const [, req] of this.pendingRequests) {
+      clearTimeout(req.timer);
+      req.reject(new Error("WebSocket closed"));
+    }
+    this.pendingRequests.clear();
+    if (this.ws) {
+      this.ws.close();
+      this.ws = null;
+    }
+    this.connectPromise = null;
+  }
+  // ============================================
+  // Internal
+  // ============================================
+  buildStreamKey(stream, params) {
+    const parts = [stream, ...Object.entries(params).sort().map(([k, v]) => `${k}=${v}`)];
+    return parts.join("&");
+  }
+  buildQueryString() {
+    const subs = [...this.subscriptions.values()];
+    if (subs.length === 0) return "";
+    const first = subs[0];
+    const params = new URLSearchParams({ stream: first.stream, ...first.params });
+    return "?" + params.toString();
+  }
+  subscribe(stream, params, eventType, callback) {
+    const key = this.buildStreamKey(stream, params);
+    this.subscriptions.set(key, { stream, params, callback, eventType });
+    if (this.connected) {
+      this.sendSubscribe(stream, params);
+    } else {
+      this.connect();
+    }
+    return () => {
+      this.subscriptions.delete(key);
+      if (this.connected) {
+        this.sendUnsubscribe(stream, params);
+      }
+    };
+  }
+  async doConnect() {
+    this.intentionallyClosed = false;
+    return new Promise((resolve, reject) => {
+      const qs = this.buildQueryString();
+      const ws = new this.WebSocketImpl(this.url + qs);
+      ws.onopen = () => {
+        this.ws = ws;
+        this.reconnectAttempts = 0;
+        this.startHeartbeat();
+        const subs = [...this.subscriptions.values()];
+        for (const sub of subs.slice(1)) {
+          this.sendSubscribe(sub.stream, sub.params);
+        }
+        resolve();
+      };
+      ws.onmessage = (event) => {
+        this.handleMessage(event.data);
+      };
+      ws.onclose = () => {
+        this.ws = null;
+        this.connectPromise = null;
+        this.stopHeartbeat();
+        if (!this.intentionallyClosed) {
+          this.scheduleReconnect();
+        }
+      };
+      ws.onerror = (err) => {
+        if (!this.ws) {
+          reject(new Error("WebSocket connection failed"));
+        }
+      };
+    });
+  }
+  handleMessage(raw) {
+    let msg;
+    try {
+      msg = JSON.parse(raw);
+    } catch {
+      return;
+    }
+    if (msg.type === "ping") {
+      this.send({ method: "PONG" });
+      return;
+    }
+    const responseId = typeof msg.id === "string" ? msg.id : typeof msg.requestId === "string" ? msg.requestId : null;
+    if (responseId && this.pendingRequests.has(responseId)) {
+      const req = this.pendingRequests.get(responseId);
+      this.pendingRequests.delete(responseId);
+      clearTimeout(req.timer);
+      req.resolve(msg);
+      return;
+    }
+    const eventType = msg.type;
+    if (!eventType) return;
+    for (const sub of this.subscriptions.values()) {
+      if (sub.eventType === eventType) {
+        try {
+          sub.callback(msg);
+        } catch {
+        }
+      }
+    }
+  }
+  sendSubscribe(stream, params) {
+    this.send({ method: "SUBSCRIBE", params: [{ stream, ...params }] });
+  }
+  sendUnsubscribe(stream, params) {
+    this.send({ method: "UNSUBSCRIBE", params: [{ stream, ...params }] });
+  }
+  sendRequest(payload, timeoutMs = 1e4) {
+    const requestId = crypto.randomUUID();
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        this.pendingRequests.delete(requestId);
+        reject(new Error("Request timed out"));
+      }, timeoutMs);
+      this.pendingRequests.set(requestId, { resolve, reject, timer });
+      if (!this.connected) {
+        this.connect().then(() => {
+          this.send({ ...payload, id: requestId });
+        }).catch(reject);
+      } else {
+        this.send({ ...payload, id: requestId });
+      }
+    });
+  }
+  send(data) {
+    if (this.ws?.readyState === WS_OPEN) {
+      this.ws.send(JSON.stringify(data));
+    }
+  }
+  // ============================================
+  // Heartbeat
+  // ============================================
+  startHeartbeat() {
+    this.stopHeartbeat();
+    this.heartbeatTimer = setInterval(() => {
+      this.send({ method: "PING" });
+    }, this.heartbeatIntervalMs);
+  }
+  stopHeartbeat() {
+    if (this.heartbeatTimer) {
+      clearInterval(this.heartbeatTimer);
+      this.heartbeatTimer = null;
+    }
+  }
+  // ============================================
+  // Reconnect
+  // ============================================
+  scheduleReconnect() {
+    if (!this.reconnectEnabled) return;
+    if (this.reconnectAttempts >= this.maxReconnectAttempts) return;
+    const delay = Math.min(1e3 * 2 ** this.reconnectAttempts, 3e4);
+    this.reconnectAttempts++;
+    this.reconnectTimer = setTimeout(() => {
+      this.reconnectTimer = null;
+      this.connect().catch(() => {
+      });
+    }, delay);
+  }
+  clearTimers() {
+    this.stopHeartbeat();
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = null;
+    }
+  }
+};
+
+export { AlphaClient, AlphaWebSocket, DEFAULT_API_BASE_URL, DEFAULT_MARKET_CREATOR_ADDRESS, DEFAULT_WSS_BASE_URL, calculateFee, calculateFeeFromTotal, calculateMatchingOrders, checkAssetOptIn, decodeGlobalState, getEscrowGlobalState, getLiveMarketsFromApi, getMarketFromApi, getMarketGlobalState, getMarketOnChain, getMarketsOnChain };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map