@0xarchive/sdk 0.3.1 → 0.3.3

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts","../src/http.ts","../src/resources/orderbook.ts","../src/resources/trades.ts","../src/resources/instruments.ts","../src/resources/funding.ts","../src/resources/openinterest.ts","../src/client.ts","../src/websocket.ts"],"sourcesContent":["/**\r\n * Configuration options for the 0xarchive client\r\n */\r\nexport interface ClientOptions {\r\n  /** Your 0xarchive API key */\r\n  apiKey: string;\r\n  /** Base URL for the API (defaults to https://api.0xarchive.io) */\r\n  baseUrl?: string;\r\n  /** Request timeout in milliseconds (defaults to 30000) */\r\n  timeout?: number;\r\n}\r\n\r\n/**\r\n * Response metadata\r\n */\r\nexport interface ApiMeta {\r\n  /** Number of records returned */\r\n  count: number;\r\n  /** Cursor for next page (if available) */\r\n  next_cursor?: string;\r\n  /** Unique request ID for debugging */\r\n  request_id: string;\r\n}\r\n\r\n/**\r\n * Standard API response wrapper\r\n */\r\nexport interface ApiResponse<T> {\r\n  success: boolean;\r\n  data: T;\r\n  meta: ApiMeta;\r\n}\r\n\r\n/**\r\n * Pagination parameters for list endpoints\r\n * @deprecated Use cursor-based pagination instead (CursorPaginationParams)\r\n */\r\nexport interface PaginationParams {\r\n  /** Maximum number of results to return */\r\n  limit?: number;\r\n  /** @deprecated Use cursor instead. Number of results to skip */\r\n  offset?: number;\r\n}\r\n\r\n/**\r\n * Time range parameters for historical queries\r\n * @deprecated Use CursorPaginationParams for better performance with large datasets\r\n */\r\nexport interface TimeRangeParams extends PaginationParams {\r\n  /** Start timestamp (Unix ms or ISO string) - REQUIRED for history endpoints */\r\n  start: number | string;\r\n  /** End timestamp (Unix ms or ISO string) - REQUIRED for history endpoints */\r\n  end: number | string;\r\n}\r\n\r\n// =============================================================================\r\n// Order Book Types\r\n// =============================================================================\r\n\r\n/**\r\n * A price level in the order book\r\n */\r\nexport interface PriceLevel {\r\n  /** Price at this level */\r\n  px: string;\r\n  /** Total size at this price level */\r\n  sz: string;\r\n  /** Number of orders at this level */\r\n  n: number;\r\n}\r\n\r\n/**\r\n * Order book snapshot\r\n */\r\nexport interface OrderBook {\r\n  /** Trading pair symbol (e.g., BTC, ETH) */\r\n  coin: string;\r\n  /** Snapshot timestamp (UTC) */\r\n  timestamp: string;\r\n  /** Bid price levels (best bid first) */\r\n  bids: PriceLevel[];\r\n  /** Ask price levels (best ask first) */\r\n  asks: PriceLevel[];\r\n  /** Mid price (best bid + best ask) / 2 */\r\n  mid_price?: string;\r\n  /** Spread in absolute terms (best ask - best bid) */\r\n  spread?: string;\r\n  /** Spread in basis points */\r\n  spread_bps?: string;\r\n}\r\n\r\nexport interface GetOrderBookParams {\r\n  /** Timestamp to get order book at (Unix ms or ISO string) */\r\n  timestamp?: number | string;\r\n  /** Number of price levels to return per side */\r\n  depth?: number;\r\n}\r\n\r\nexport interface OrderBookHistoryParams extends TimeRangeParams {\r\n  /** Number of price levels to return per side */\r\n  depth?: number;\r\n}\r\n\r\n// =============================================================================\r\n// Trade/Fill Types\r\n// =============================================================================\r\n\r\n/** Trade side: 'A' (ask/sell) or 'B' (bid/buy) */\r\nexport type TradeSide = 'A' | 'B';\r\n\r\n/** Position direction */\r\nexport type TradeDirection = 'Open Long' | 'Open Short' | 'Close Long' | 'Close Short';\r\n\r\n/** Data source */\r\nexport type DataSource = 's3' | 'ws' | 'api';\r\n\r\n/**\r\n * Trade/fill record with full execution details\r\n */\r\nexport interface Trade {\r\n  /** Trading pair symbol */\r\n  coin: string;\r\n  /** Trade side: 'A' (ask/sell) or 'B' (bid/buy) */\r\n  side: TradeSide;\r\n  /** Execution price */\r\n  price: string;\r\n  /** Trade size */\r\n  size: string;\r\n  /** Execution timestamp (UTC) */\r\n  timestamp: string;\r\n  /** Blockchain transaction hash */\r\n  tx_hash?: string;\r\n  /** Unique trade ID */\r\n  trade_id?: number;\r\n  /** Associated order ID */\r\n  order_id?: number;\r\n  /** True if taker (crossed the spread), false if maker */\r\n  crossed?: boolean;\r\n  /** Trading fee amount */\r\n  fee?: string;\r\n  /** Fee denomination (e.g., USDC) */\r\n  fee_token?: string;\r\n  /** Realized PnL if closing a position */\r\n  closed_pnl?: string;\r\n  /** Position direction */\r\n  direction?: TradeDirection;\r\n  /** Position size before this trade */\r\n  start_position?: string;\r\n  /** Data source */\r\n  source?: DataSource;\r\n  /** User's wallet address */\r\n  user_address?: string;\r\n}\r\n\r\n/**\r\n * @deprecated Use GetTradesCursorParams instead for better performance with large datasets\r\n */\r\nexport interface GetTradesParams extends TimeRangeParams {\r\n  /** Filter by side */\r\n  side?: TradeSide;\r\n}\r\n\r\n/**\r\n * Cursor-based pagination parameters for trades (recommended)\r\n * More efficient than offset-based pagination for large datasets.\r\n * The cursor is a timestamp - use the `nextCursor` from the response to get the next page.\r\n */\r\nexport interface CursorPaginationParams {\r\n  /** Start timestamp (Unix ms or ISO string) - REQUIRED */\r\n  start: number | string;\r\n  /** End timestamp (Unix ms or ISO string) - REQUIRED */\r\n  end: number | string;\r\n  /** Cursor from previous response's nextCursor (timestamp). If not provided, starts from the beginning of the range. */\r\n  cursor?: number | string;\r\n  /** Maximum number of results to return (default: 100, max: 1000) */\r\n  limit?: number;\r\n}\r\n\r\n/**\r\n * Parameters for getting trades with cursor-based pagination (recommended)\r\n */\r\nexport interface GetTradesCursorParams extends CursorPaginationParams {\r\n  /** Filter by side */\r\n  side?: TradeSide;\r\n}\r\n\r\n/**\r\n * Response with cursor for pagination\r\n */\r\nexport interface CursorResponse<T> {\r\n  data: T;\r\n  /** Cursor for next page (use as cursor parameter) */\r\n  nextCursor?: string;\r\n}\r\n\r\n// =============================================================================\r\n// Instruments Types\r\n// =============================================================================\r\n\r\n/** Instrument type */\r\nexport type InstrumentType = 'perp' | 'spot';\r\n\r\n/**\r\n * Trading instrument metadata\r\n */\r\nexport interface Instrument {\r\n  /** Instrument symbol (e.g., BTC) */\r\n  name: string;\r\n  /** Size decimal precision */\r\n  szDecimals: number;\r\n  /** Maximum leverage allowed */\r\n  maxLeverage?: number;\r\n  /** If true, only isolated margin mode is allowed */\r\n  onlyIsolated?: boolean;\r\n  /** Type of instrument */\r\n  instrumentType?: InstrumentType;\r\n  /** Whether the instrument is currently tradeable */\r\n  isActive: boolean;\r\n}\r\n\r\n// =============================================================================\r\n// Funding Types\r\n// =============================================================================\r\n\r\n/**\r\n * Funding rate record\r\n */\r\nexport interface FundingRate {\r\n  /** Trading pair symbol */\r\n  coin: string;\r\n  /** Funding timestamp (UTC) */\r\n  timestamp: string;\r\n  /** Funding rate as decimal (e.g., 0.0001 = 0.01%) */\r\n  funding_rate: string;\r\n  /** Premium component of funding rate */\r\n  premium?: string;\r\n}\r\n\r\n// =============================================================================\r\n// Open Interest Types\r\n// =============================================================================\r\n\r\n/**\r\n * Open interest snapshot with market context\r\n */\r\nexport interface OpenInterest {\r\n  /** Trading pair symbol */\r\n  coin: string;\r\n  /** Snapshot timestamp (UTC) */\r\n  timestamp: string;\r\n  /** Total open interest in contracts */\r\n  open_interest: string;\r\n  /** Mark price used for liquidations */\r\n  mark_price?: string;\r\n  /** Oracle price from external feed */\r\n  oracle_price?: string;\r\n  /** 24-hour notional volume */\r\n  day_ntl_volume?: string;\r\n  /** Price 24 hours ago */\r\n  prev_day_price?: string;\r\n  /** Current mid price */\r\n  mid_price?: string;\r\n  /** Impact bid price for liquidations */\r\n  impact_bid_price?: string;\r\n  /** Impact ask price for liquidations */\r\n  impact_ask_price?: string;\r\n}\r\n\r\n// =============================================================================\r\n// WebSocket Types\r\n// =============================================================================\r\n\r\n/** WebSocket channel types. Note: ticker/all_tickers are real-time only. */\r\nexport type WsChannel = 'orderbook' | 'trades' | 'ticker' | 'all_tickers';\r\n\r\n/** Subscribe message from client */\r\nexport interface WsSubscribe {\r\n  op: 'subscribe';\r\n  channel: WsChannel;\r\n  coin?: string;\r\n}\r\n\r\n/** Unsubscribe message from client */\r\nexport interface WsUnsubscribe {\r\n  op: 'unsubscribe';\r\n  channel: WsChannel;\r\n  coin?: string;\r\n}\r\n\r\n/** Ping message from client */\r\nexport interface WsPing {\r\n  op: 'ping';\r\n}\r\n\r\n/** Replay message from client - replays historical data with timing preserved */\r\nexport interface WsReplay {\r\n  op: 'replay';\r\n  channel: WsChannel;\r\n  coin?: string;\r\n  /** Start timestamp (Unix ms) */\r\n  start: number;\r\n  /** End timestamp (Unix ms, defaults to now) */\r\n  end?: number;\r\n  /** Playback speed multiplier (1 = real-time, 10 = 10x faster) */\r\n  speed?: number;\r\n}\r\n\r\n/** Replay control messages */\r\nexport interface WsReplayPause { op: 'replay.pause'; }\r\nexport interface WsReplayResume { op: 'replay.resume'; }\r\nexport interface WsReplaySeek { op: 'replay.seek'; timestamp: number; }\r\nexport interface WsReplayStop { op: 'replay.stop'; }\r\n\r\n/** Stream message from client - bulk download historical data */\r\nexport interface WsStream {\r\n  op: 'stream';\r\n  channel: WsChannel;\r\n  coin?: string;\r\n  /** Start timestamp (Unix ms) */\r\n  start: number;\r\n  /** End timestamp (Unix ms) */\r\n  end: number;\r\n  /** Batch size (records per message) */\r\n  batch_size?: number;\r\n}\r\n\r\n/** Stream control messages */\r\nexport interface WsStreamStop { op: 'stream.stop'; }\r\n\r\n/** Client message union type */\r\nexport type WsClientMessage =\r\n  | WsSubscribe\r\n  | WsUnsubscribe\r\n  | WsPing\r\n  | WsReplay\r\n  | WsReplayPause\r\n  | WsReplayResume\r\n  | WsReplaySeek\r\n  | WsReplayStop\r\n  | WsStream\r\n  | WsStreamStop;\r\n\r\n/** Subscription confirmed from server */\r\nexport interface WsSubscribed {\r\n  type: 'subscribed';\r\n  channel: WsChannel;\r\n  coin?: string;\r\n}\r\n\r\n/** Unsubscription confirmed from server */\r\nexport interface WsUnsubscribed {\r\n  type: 'unsubscribed';\r\n  channel: WsChannel;\r\n  coin?: string;\r\n}\r\n\r\n/** Pong response from server */\r\nexport interface WsPong {\r\n  type: 'pong';\r\n}\r\n\r\n/** Error from server */\r\nexport interface WsError {\r\n  type: 'error';\r\n  message: string;\r\n}\r\n\r\n/** Data message from server (real-time) */\r\nexport interface WsData<T = unknown> {\r\n  type: 'data';\r\n  channel: WsChannel;\r\n  coin: string;\r\n  data: T;\r\n}\r\n\r\n/** Replay started response */\r\nexport interface WsReplayStarted {\r\n  type: 'replay_started';\r\n  channel: WsChannel;\r\n  coin: string;\r\n  /** Start timestamp in milliseconds */\r\n  start: number;\r\n  /** End timestamp in milliseconds */\r\n  end: number;\r\n  /** Playback speed multiplier */\r\n  speed: number;\r\n}\r\n\r\n/** Replay paused response */\r\nexport interface WsReplayPaused {\r\n  type: 'replay_paused';\r\n  current_timestamp: number;\r\n}\r\n\r\n/** Replay resumed response */\r\nexport interface WsReplayResumed {\r\n  type: 'replay_resumed';\r\n  current_timestamp: number;\r\n}\r\n\r\n/** Replay completed response */\r\nexport interface WsReplayCompleted {\r\n  type: 'replay_completed';\r\n  channel: WsChannel;\r\n  coin: string;\r\n  snapshots_sent: number;\r\n}\r\n\r\n/** Replay stopped response */\r\nexport interface WsReplayStopped {\r\n  type: 'replay_stopped';\r\n}\r\n\r\n/** Historical data point (replay mode) */\r\nexport interface WsHistoricalData<T = unknown> {\r\n  type: 'historical_data';\r\n  channel: WsChannel;\r\n  coin: string;\r\n  timestamp: number;\r\n  data: T;\r\n}\r\n\r\n/** Stream started response */\r\nexport interface WsStreamStarted {\r\n  type: 'stream_started';\r\n  channel: WsChannel;\r\n  coin: string;\r\n  /** Start timestamp in milliseconds */\r\n  start: number;\r\n  /** End timestamp in milliseconds */\r\n  end: number;\r\n}\r\n\r\n/** Stream progress response (sent periodically during streaming) */\r\nexport interface WsStreamProgress {\r\n  type: 'stream_progress';\r\n  snapshots_sent: number;\r\n}\r\n\r\n/** A record with timestamp for batched data */\r\nexport interface TimestampedRecord<T = unknown> {\r\n  timestamp: number;\r\n  data: T;\r\n}\r\n\r\n/** Batch of historical data (bulk streaming) */\r\nexport interface WsHistoricalBatch<T = unknown> {\r\n  type: 'historical_batch';\r\n  channel: WsChannel;\r\n  coin: string;\r\n  data: TimestampedRecord<T>[];\r\n}\r\n\r\n/** Stream completed response */\r\nexport interface WsStreamCompleted {\r\n  type: 'stream_completed';\r\n  channel: WsChannel;\r\n  coin: string;\r\n  snapshots_sent: number;\r\n}\r\n\r\n/** Stream stopped response */\r\nexport interface WsStreamStopped {\r\n  type: 'stream_stopped';\r\n  snapshots_sent: number;\r\n}\r\n\r\n/** Server message union type */\r\nexport type WsServerMessage =\r\n  | WsSubscribed\r\n  | WsUnsubscribed\r\n  | WsPong\r\n  | WsError\r\n  | WsData\r\n  | WsReplayStarted\r\n  | WsReplayPaused\r\n  | WsReplayResumed\r\n  | WsReplayCompleted\r\n  | WsReplayStopped\r\n  | WsHistoricalData\r\n  | WsStreamStarted\r\n  | WsStreamProgress\r\n  | WsHistoricalBatch\r\n  | WsStreamCompleted\r\n  | WsStreamStopped;\r\n\r\n/**\r\n * WebSocket connection options.\r\n *\r\n * The server sends WebSocket ping frames every 30 seconds and will disconnect\r\n * idle connections after 60 seconds. The SDK automatically handles keep-alive\r\n * by sending application-level pings at the configured interval.\r\n */\r\nexport interface WsOptions {\r\n  /** API key for authentication */\r\n  apiKey: string;\r\n  /** WebSocket URL (defaults to wss://api.0xarchive.io/ws) */\r\n  wsUrl?: string;\r\n  /** Auto-reconnect on disconnect (defaults to true) */\r\n  autoReconnect?: boolean;\r\n  /** Reconnect delay in ms (defaults to 1000) */\r\n  reconnectDelay?: number;\r\n  /** Maximum reconnect attempts (defaults to 10) */\r\n  maxReconnectAttempts?: number;\r\n  /** Ping interval in ms to keep connection alive (defaults to 30000). Server disconnects after 60s idle. */\r\n  pingInterval?: number;\r\n}\r\n\r\n/** WebSocket connection state */\r\nexport type WsConnectionState = 'connecting' | 'connected' | 'disconnected' | 'reconnecting';\r\n\r\n/** WebSocket event handlers */\r\nexport interface WsEventHandlers {\r\n  onOpen?: () => void;\r\n  onClose?: (code: number, reason: string) => void;\r\n  onError?: (error: Error) => void;\r\n  onMessage?: (message: WsServerMessage) => void;\r\n  onStateChange?: (state: WsConnectionState) => void;\r\n}\r\n\r\n// =============================================================================\r\n// Error Types\r\n// =============================================================================\r\n\r\n/**\r\n * API error response\r\n */\r\nexport interface ApiError {\r\n  code: number;\r\n  error: string;\r\n}\r\n\r\n/**\r\n * SDK error class\r\n */\r\nexport class OxArchiveError extends Error {\r\n  code: number;\r\n  requestId?: string;\r\n\r\n  constructor(message: string, code: number, requestId?: string) {\r\n    super(message);\r\n    this.name = 'OxArchiveError';\r\n    this.code = code;\r\n    this.requestId = requestId;\r\n  }\r\n}\r\n\r\n/** Timestamp can be Unix ms (number), ISO string, or Date object */\r\nexport type Timestamp = number | string | Date;\r\n","import type { ApiResponse, ApiError } from './types';\r\nimport { OxArchiveError } from './types';\r\n\r\nexport interface HttpClientOptions {\r\n  baseUrl: string;\r\n  apiKey: string;\r\n  timeout: number;\r\n}\r\n\r\n/**\r\n * Internal HTTP client for making API requests\r\n */\r\nexport class HttpClient {\r\n  private baseUrl: string;\r\n  private apiKey: string;\r\n  private timeout: number;\r\n\r\n  constructor(options: HttpClientOptions) {\r\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '');\r\n    this.apiKey = options.apiKey;\r\n    this.timeout = options.timeout;\r\n  }\r\n\r\n  /**\r\n   * Make a GET request to the API\r\n   */\r\n  async get<T>(path: string, params?: Record<string, unknown>): Promise<T> {\r\n    const url = new URL(`${this.baseUrl}${path}`);\r\n\r\n    if (params) {\r\n      for (const [key, value] of Object.entries(params)) {\r\n        if (value !== undefined && value !== null) {\r\n          url.searchParams.set(key, String(value));\r\n        }\r\n      }\r\n    }\r\n\r\n    const controller = new AbortController();\r\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\r\n\r\n    try {\r\n      const response = await fetch(url.toString(), {\r\n        method: 'GET',\r\n        headers: {\r\n          'X-API-Key': this.apiKey,\r\n          'Content-Type': 'application/json',\r\n        },\r\n        signal: controller.signal,\r\n      });\r\n\r\n      clearTimeout(timeoutId);\r\n\r\n      const data = await response.json();\r\n\r\n      if (!response.ok) {\r\n        const error = data as ApiError;\r\n        throw new OxArchiveError(\r\n          error.error || `Request failed with status ${response.status}`,\r\n          response.status,\r\n          (data as ApiResponse<unknown>).meta?.request_id\r\n        );\r\n      }\r\n\r\n      return data as T;\r\n    } catch (error) {\r\n      clearTimeout(timeoutId);\r\n\r\n      if (error instanceof OxArchiveError) {\r\n        throw error;\r\n      }\r\n\r\n      if (error instanceof Error && error.name === 'AbortError') {\r\n        throw new OxArchiveError(`Request timeout after ${this.timeout}ms`, 408);\r\n      }\r\n\r\n      throw new OxArchiveError(\r\n        error instanceof Error ? error.message : 'Unknown error',\r\n        500\r\n      );\r\n    }\r\n  }\r\n}\r\n","import type { HttpClient } from '../http';\r\nimport type {\r\n  ApiResponse,\r\n  OrderBook,\r\n  GetOrderBookParams,\r\n  OrderBookHistoryParams,\r\n} from '../types';\r\n\r\n/**\r\n * Order book API resource\r\n *\r\n * @example\r\n * ```typescript\r\n * // Get current order book\r\n * const orderbook = await client.orderbook.get('BTC');\r\n *\r\n * // Get order book at specific timestamp\r\n * const historical = await client.orderbook.get('ETH', {\r\n *   timestamp: 1704067200000,\r\n *   depth: 10\r\n * });\r\n *\r\n * // Get order book history\r\n * const history = await client.orderbook.history('BTC', {\r\n *   start: Date.now() - 86400000,\r\n *   end: Date.now(),\r\n *   limit: 100\r\n * });\r\n * ```\r\n */\r\nexport class OrderBookResource {\r\n  constructor(private http: HttpClient) {}\r\n\r\n  /**\r\n   * Get order book snapshot for a coin\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @param params - Optional parameters\r\n   * @returns Order book snapshot\r\n   */\r\n  async get(coin: string, params?: GetOrderBookParams): Promise<OrderBook> {\r\n    const response = await this.http.get<ApiResponse<OrderBook>>(\r\n      `/v1/orderbook/${coin.toUpperCase()}`,\r\n      params as Record<string, unknown>\r\n    );\r\n    return response.data;\r\n  }\r\n\r\n  /**\r\n   * Get historical order book snapshots\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @param params - Time range and pagination parameters (start is required)\r\n   * @returns Array of order book snapshots\r\n   */\r\n  async history(\r\n    coin: string,\r\n    params: OrderBookHistoryParams\r\n  ): Promise<OrderBook[]> {\r\n    const response = await this.http.get<ApiResponse<OrderBook[]>>(\r\n      `/v1/orderbook/${coin.toUpperCase()}/history`,\r\n      params as unknown as Record<string, unknown>\r\n    );\r\n    return response.data;\r\n  }\r\n}\r\n","import type { HttpClient } from '../http';\r\nimport type { ApiResponse, Trade, GetTradesParams, GetTradesCursorParams, CursorResponse } from '../types';\r\n\r\n/**\r\n * Trades API resource\r\n *\r\n * @example\r\n * ```typescript\r\n * // Get recent trades\r\n * const trades = await client.trades.recent('BTC');\r\n *\r\n * // Get trade history with cursor-based pagination (recommended)\r\n * let result = await client.trades.list('BTC', {\r\n *   start: Date.now() - 86400000,\r\n *   end: Date.now(),\r\n *   limit: 1000\r\n * });\r\n *\r\n * // Get all pages\r\n * const allTrades = [...result.data];\r\n * while (result.nextCursor) {\r\n *   result = await client.trades.list('BTC', {\r\n *     start: Date.now() - 86400000,\r\n *     end: Date.now(),\r\n *     cursor: result.nextCursor,\r\n *     limit: 1000\r\n *   });\r\n *   allTrades.push(...result.data);\r\n * }\r\n * ```\r\n */\r\nexport class TradesResource {\r\n  constructor(private http: HttpClient) {}\r\n\r\n  /**\r\n   * Get trade history for a coin using cursor-based pagination\r\n   *\r\n   * Uses cursor-based pagination by default, which is more efficient for large datasets.\r\n   * Use the `nextCursor` from the response as the `cursor` parameter to get the next page.\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @param params - Time range and cursor pagination parameters (start and end are required)\r\n   * @returns Object with trades array and nextCursor for pagination\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * // First page\r\n   * let result = await client.trades.list('BTC', {\r\n   *   start: Date.now() - 86400000,\r\n   *   end: Date.now(),\r\n   *   limit: 1000\r\n   * });\r\n   *\r\n   * // Subsequent pages\r\n   * while (result.nextCursor) {\r\n   *   result = await client.trades.list('BTC', {\r\n   *     start: Date.now() - 86400000,\r\n   *     end: Date.now(),\r\n   *     cursor: result.nextCursor,\r\n   *     limit: 1000\r\n   *   });\r\n   * }\r\n   * ```\r\n   */\r\n  async list(coin: string, params: GetTradesCursorParams): Promise<CursorResponse<Trade[]>> {\r\n    const response = await this.http.get<ApiResponse<Trade[]>>(\r\n      `/v1/trades/${coin.toUpperCase()}`,\r\n      params as unknown as Record<string, unknown>\r\n    );\r\n    return {\r\n      data: response.data,\r\n      nextCursor: response.meta.next_cursor,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Get most recent trades for a coin\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @param limit - Number of trades to return (default: 100)\r\n   * @returns Array of recent trades\r\n   */\r\n  async recent(coin: string, limit?: number): Promise<Trade[]> {\r\n    const response = await this.http.get<ApiResponse<Trade[]>>(\r\n      `/v1/trades/${coin.toUpperCase()}/recent`,\r\n      { limit }\r\n    );\r\n    return response.data;\r\n  }\r\n\r\n  /**\r\n   * Get trade history using cursor-based pagination (explicit endpoint)\r\n   *\r\n   * @deprecated Use `list()` instead - it now uses cursor-based pagination by default.\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @param params - Cursor pagination parameters (start and end are required)\r\n   * @returns Object with trades array and nextCursor for pagination\r\n   */\r\n  async listWithCursor(coin: string, params: GetTradesCursorParams): Promise<CursorResponse<Trade[]>> {\r\n    // Now just calls the main endpoint since it supports cursor by default\r\n    return this.list(coin, params);\r\n  }\r\n\r\n  /**\r\n   * Get trade history using offset-based pagination\r\n   *\r\n   * @deprecated Use `list()` with cursor-based pagination instead for better performance.\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @param params - Time range and offset pagination parameters\r\n   * @returns Array of trades (without cursor response wrapper)\r\n   */\r\n  async listWithOffset(coin: string, params: GetTradesParams): Promise<Trade[]> {\r\n    const response = await this.http.get<ApiResponse<Trade[]>>(\r\n      `/v1/trades/${coin.toUpperCase()}`,\r\n      params as unknown as Record<string, unknown>\r\n    );\r\n    return response.data;\r\n  }\r\n}\r\n","import type { HttpClient } from '../http';\r\nimport type { ApiResponse, Instrument } from '../types';\r\n\r\n/**\r\n * Instruments API resource\r\n *\r\n * @example\r\n * ```typescript\r\n * // List all instruments\r\n * const instruments = await client.instruments.list();\r\n *\r\n * // Get specific instrument\r\n * const btc = await client.instruments.get('BTC');\r\n * ```\r\n */\r\nexport class InstrumentsResource {\r\n  constructor(private http: HttpClient) {}\r\n\r\n  /**\r\n   * List all available trading instruments\r\n   *\r\n   * @returns Array of instruments\r\n   */\r\n  async list(): Promise<Instrument[]> {\r\n    const response = await this.http.get<ApiResponse<Instrument[]>>(\r\n      '/v1/instruments'\r\n    );\r\n    return response.data;\r\n  }\r\n\r\n  /**\r\n   * Get a specific instrument by coin symbol\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @returns Instrument details\r\n   */\r\n  async get(coin: string): Promise<Instrument> {\r\n    const response = await this.http.get<ApiResponse<Instrument>>(\r\n      `/v1/instruments/${coin.toUpperCase()}`\r\n    );\r\n    return response.data;\r\n  }\r\n}\r\n","import type { HttpClient } from '../http';\r\nimport type { ApiResponse, FundingRate, TimeRangeParams } from '../types';\r\n\r\n/**\r\n * Funding rates API resource\r\n *\r\n * @example\r\n * ```typescript\r\n * // Get current funding rate\r\n * const current = await client.funding.current('BTC');\r\n *\r\n * // Get funding rate history\r\n * const history = await client.funding.history('ETH', {\r\n *   start: Date.now() - 86400000 * 7,\r\n *   end: Date.now()\r\n * });\r\n * ```\r\n */\r\nexport class FundingResource {\r\n  constructor(private http: HttpClient) {}\r\n\r\n  /**\r\n   * Get funding rate history for a coin\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @param params - Time range and pagination parameters (start is required)\r\n   * @returns Array of funding rate records\r\n   */\r\n  async history(coin: string, params: TimeRangeParams): Promise<FundingRate[]> {\r\n    const response = await this.http.get<ApiResponse<FundingRate[]>>(\r\n      `/v1/funding/${coin.toUpperCase()}`,\r\n      params as unknown as Record<string, unknown>\r\n    );\r\n    return response.data;\r\n  }\r\n\r\n  /**\r\n   * Get current funding rate for a coin\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @returns Current funding rate\r\n   */\r\n  async current(coin: string): Promise<FundingRate> {\r\n    const response = await this.http.get<ApiResponse<FundingRate>>(\r\n      `/v1/funding/${coin.toUpperCase()}/current`\r\n    );\r\n    return response.data;\r\n  }\r\n}\r\n","import type { HttpClient } from '../http';\r\nimport type { ApiResponse, OpenInterest, TimeRangeParams } from '../types';\r\n\r\n/**\r\n * Open interest API resource\r\n *\r\n * @example\r\n * ```typescript\r\n * // Get current open interest\r\n * const current = await client.openInterest.current('BTC');\r\n *\r\n * // Get open interest history\r\n * const history = await client.openInterest.history('ETH', {\r\n *   start: Date.now() - 86400000,\r\n *   end: Date.now(),\r\n *   limit: 100\r\n * });\r\n * ```\r\n */\r\nexport class OpenInterestResource {\r\n  constructor(private http: HttpClient) {}\r\n\r\n  /**\r\n   * Get open interest history for a coin\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @param params - Time range and pagination parameters (start is required)\r\n   * @returns Array of open interest records\r\n   */\r\n  async history(coin: string, params: TimeRangeParams): Promise<OpenInterest[]> {\r\n    const response = await this.http.get<ApiResponse<OpenInterest[]>>(\r\n      `/v1/openinterest/${coin.toUpperCase()}`,\r\n      params as unknown as Record<string, unknown>\r\n    );\r\n    return response.data;\r\n  }\r\n\r\n  /**\r\n   * Get current open interest for a coin\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @returns Current open interest\r\n   */\r\n  async current(coin: string): Promise<OpenInterest> {\r\n    const response = await this.http.get<ApiResponse<OpenInterest>>(\r\n      `/v1/openinterest/${coin.toUpperCase()}/current`\r\n    );\r\n    return response.data;\r\n  }\r\n}\r\n","import type { ClientOptions } from './types';\r\nimport { HttpClient } from './http';\r\nimport {\r\n  OrderBookResource,\r\n  TradesResource,\r\n  InstrumentsResource,\r\n  FundingResource,\r\n  OpenInterestResource,\r\n} from './resources';\r\n\r\nconst DEFAULT_BASE_URL = 'https://api.0xarchive.io';\r\nconst DEFAULT_TIMEOUT = 30000;\r\n\r\n/**\r\n * 0xarchive API client\r\n *\r\n * @example\r\n * ```typescript\r\n * import { OxArchive } from '@0xarchive/sdk';\r\n *\r\n * const client = new OxArchive({ apiKey: 'ox_your_api_key' });\r\n *\r\n * // Get current order book\r\n * const orderbook = await client.orderbook.get('BTC');\r\n * console.log(`BTC mid price: ${orderbook.mid_price}`);\r\n *\r\n * // Get historical data\r\n * const history = await client.orderbook.history('ETH', {\r\n *   start: Date.now() - 86400000,\r\n *   end: Date.now(),\r\n *   limit: 100\r\n * });\r\n *\r\n * // List all instruments\r\n * const instruments = await client.instruments.list();\r\n * ```\r\n */\r\nexport class OxArchive {\r\n  private http: HttpClient;\r\n\r\n  /**\r\n   * Order book data (L2 snapshots from April 2023)\r\n   */\r\n  public readonly orderbook: OrderBookResource;\r\n\r\n  /**\r\n   * Trade/fill history\r\n   */\r\n  public readonly trades: TradesResource;\r\n\r\n  /**\r\n   * Trading instruments metadata\r\n   */\r\n  public readonly instruments: InstrumentsResource;\r\n\r\n  /**\r\n   * Funding rates\r\n   */\r\n  public readonly funding: FundingResource;\r\n\r\n  /**\r\n   * Open interest\r\n   */\r\n  public readonly openInterest: OpenInterestResource;\r\n\r\n  /**\r\n   * Create a new 0xarchive client\r\n   *\r\n   * @param options - Client configuration options\r\n   */\r\n  constructor(options: ClientOptions) {\r\n    if (!options.apiKey) {\r\n      throw new Error('API key is required. Get one at https://0xarchive.io/signup');\r\n    }\r\n\r\n    this.http = new HttpClient({\r\n      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,\r\n      apiKey: options.apiKey,\r\n      timeout: options.timeout ?? DEFAULT_TIMEOUT,\r\n    });\r\n\r\n    // Initialize resource namespaces\r\n    this.orderbook = new OrderBookResource(this.http);\r\n    this.trades = new TradesResource(this.http);\r\n    this.instruments = new InstrumentsResource(this.http);\r\n    this.funding = new FundingResource(this.http);\r\n    this.openInterest = new OpenInterestResource(this.http);\r\n  }\r\n}\r\n","/**\r\n * WebSocket client for 0xarchive real-time streaming, replay, and bulk download\r\n *\r\n * @example Real-time streaming\r\n * ```typescript\r\n * const ws = new OxArchiveWs({ apiKey: 'ox_...' });\r\n * ws.connect({\r\n *   onMessage: (msg) => console.log(msg)\r\n * });\r\n * ws.subscribeOrderbook('BTC');\r\n * ```\r\n *\r\n * @example Historical replay (like Tardis.dev)\r\n * ```typescript\r\n * const ws = new OxArchiveWs({ apiKey: 'ox_...' });\r\n * ws.connect();\r\n * ws.onHistoricalData((coin, timestamp, data) => {\r\n *   console.log(`${new Date(timestamp)}: ${data.mid_price}`);\r\n * });\r\n * ws.replay('orderbook', 'BTC', {\r\n *   start: Date.now() - 86400000,\r\n *   speed: 10 // 10x speed\r\n * });\r\n * ```\r\n *\r\n * @example Bulk streaming (like Databento)\r\n * ```typescript\r\n * const ws = new OxArchiveWs({ apiKey: 'ox_...' });\r\n * ws.connect();\r\n * const batches: OrderBook[] = [];\r\n * ws.onBatch((coin, records) => {\r\n *   batches.push(...records.map(r => r.data));\r\n * });\r\n * ws.onStreamComplete((channel, coin, count) => {\r\n *   console.log(`Downloaded ${count} records`);\r\n * });\r\n * ws.stream('orderbook', 'ETH', {\r\n *   start: Date.now() - 3600000,\r\n *   end: Date.now(),\r\n *   batchSize: 1000\r\n * });\r\n * ```\r\n */\r\n\r\nimport type {\r\n  WsOptions,\r\n  WsChannel,\r\n  WsClientMessage,\r\n  WsServerMessage,\r\n  WsConnectionState,\r\n  WsEventHandlers,\r\n  OrderBook,\r\n  PriceLevel,\r\n  Trade,\r\n  WsHistoricalData,\r\n  WsHistoricalBatch,\r\n  WsReplayStarted,\r\n  WsReplayCompleted,\r\n  WsStreamStarted,\r\n  WsStreamCompleted,\r\n  WsStreamProgress,\r\n} from './types';\r\n\r\nconst DEFAULT_WS_URL = 'wss://api.0xarchive.io/ws';\r\nconst DEFAULT_PING_INTERVAL = 30000; // 30 seconds\r\nconst DEFAULT_RECONNECT_DELAY = 1000;\r\nconst DEFAULT_MAX_RECONNECT_ATTEMPTS = 10;\r\n\r\n// Server idle timeout is 60 seconds. The SDK sends pings every 30 seconds\r\n// to keep the connection alive. Browser WebSocket API automatically responds\r\n// to WebSocket protocol-level ping frames from the server.\r\n\r\n/**\r\n * Transform raw Hyperliquid trade format to SDK Trade type.\r\n * Raw format: { px, sz, side, time, hash, tid }\r\n * SDK format: { coin, side, price, size, timestamp, tx_hash, trade_id }\r\n */\r\nfunction transformTrade(coin: string, raw: Record<string, unknown>): Trade {\r\n  // Check if already in SDK format (from REST API or historical replay)\r\n  if ('price' in raw && 'size' in raw) {\r\n    return raw as unknown as Trade;\r\n  }\r\n\r\n  // Transform from Hyperliquid raw format\r\n  const px = raw.px as string | undefined;\r\n  const sz = raw.sz as string | undefined;\r\n  const side = raw.side as string | undefined;\r\n  const time = raw.time as number | undefined;\r\n  const hash = raw.hash as string | undefined;\r\n  const tid = raw.tid as number | undefined;\r\n\r\n  return {\r\n    coin,\r\n    side: (side === 'A' || side === 'B' ? side : 'B') as 'A' | 'B',\r\n    price: px ?? '0',\r\n    size: sz ?? '0',\r\n    timestamp: time ? new Date(time).toISOString() : new Date().toISOString(),\r\n    tx_hash: hash,\r\n    trade_id: tid,\r\n  };\r\n}\r\n\r\n/**\r\n * Transform an array of raw Hyperliquid trades to SDK Trade types.\r\n */\r\nfunction transformTrades(coin: string, rawTrades: unknown): Trade[] {\r\n  if (!Array.isArray(rawTrades)) {\r\n    // Single trade object\r\n    return [transformTrade(coin, rawTrades as Record<string, unknown>)];\r\n  }\r\n  return rawTrades.map((raw) => transformTrade(coin, raw as Record<string, unknown>));\r\n}\r\n\r\n/**\r\n * Transform raw Hyperliquid orderbook format to SDK OrderBook type.\r\n * Raw format: { coin, levels: [[{px, sz, n}, ...], [{px, sz, n}, ...]], time }\r\n * SDK format: { coin, timestamp, bids: [{px, sz, n}], asks: [{px, sz, n}], mid_price, spread, spread_bps }\r\n */\r\nfunction transformOrderbook(coin: string, raw: Record<string, unknown>): OrderBook {\r\n  // Check if already in SDK format (from REST API or historical replay)\r\n  if ('bids' in raw && 'asks' in raw) {\r\n    return raw as unknown as OrderBook;\r\n  }\r\n\r\n  // Transform from Hyperliquid raw format\r\n  // levels is [[{px, sz, n}, ...], [{px, sz, n}, ...]] where [0]=bids, [1]=asks\r\n  const levels = raw.levels as Array<Array<{ px: string; sz: string; n: number }>> | undefined;\r\n  const time = raw.time as number | undefined;\r\n\r\n  const bids: PriceLevel[] = [];\r\n  const asks: PriceLevel[] = [];\r\n\r\n  if (levels && levels.length >= 2) {\r\n    // levels[0] = bids, levels[1] = asks\r\n    // Each level is already {px, sz, n} object\r\n    for (const level of levels[0] || []) {\r\n      bids.push({ px: level.px, sz: level.sz, n: level.n });\r\n    }\r\n    for (const level of levels[1] || []) {\r\n      asks.push({ px: level.px, sz: level.sz, n: level.n });\r\n    }\r\n  }\r\n\r\n  // Calculate mid price and spread\r\n  let mid_price: string | undefined;\r\n  let spread: string | undefined;\r\n  let spread_bps: string | undefined;\r\n\r\n  if (bids.length > 0 && asks.length > 0) {\r\n    const bestBid = parseFloat(bids[0].px);\r\n    const bestAsk = parseFloat(asks[0].px);\r\n    const mid = (bestBid + bestAsk) / 2;\r\n    mid_price = mid.toString();\r\n    spread = (bestAsk - bestBid).toString();\r\n    spread_bps = ((bestAsk - bestBid) / mid * 10000).toFixed(2);\r\n  }\r\n\r\n  return {\r\n    coin,\r\n    timestamp: time ? new Date(time).toISOString() : new Date().toISOString(),\r\n    bids,\r\n    asks,\r\n    mid_price,\r\n    spread,\r\n    spread_bps,\r\n  };\r\n}\r\n\r\n/**\r\n * WebSocket client for real-time data streaming.\r\n *\r\n * **Keep-Alive:** The server sends WebSocket ping frames every 30 seconds\r\n * and will disconnect idle connections after 60 seconds. This SDK automatically\r\n * handles keep-alive by sending application-level pings at the configured interval\r\n * (default: 30 seconds). The browser WebSocket API automatically responds to\r\n * server ping frames.\r\n */\r\nexport class OxArchiveWs {\r\n  private ws: WebSocket | null = null;\r\n  private options: Required<WsOptions>;\r\n  private handlers: WsEventHandlers = {};\r\n  private subscriptions: Set<string> = new Set();\r\n  private state: WsConnectionState = 'disconnected';\r\n  private reconnectAttempts = 0;\r\n  private pingTimer: ReturnType<typeof setInterval> | null = null;\r\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\r\n\r\n  // Typed event handlers (separate from WsEventHandlers to avoid wrapping issues)\r\n  private historicalDataHandlers: Array<(coin: string, timestamp: number, data: unknown) => void> = [];\r\n  private batchHandlers: Array<(coin: string, records: Array<{ timestamp: number; data: unknown }>) => void> = [];\r\n  private replayStartHandlers: Array<(channel: WsChannel, coin: string, start: number, end: number, speed: number) => void> = [];\r\n  private replayCompleteHandlers: Array<(channel: WsChannel, coin: string, snapshotsSent: number) => void> = [];\r\n  private streamStartHandlers: Array<(channel: WsChannel, coin: string, start: number, end: number) => void> = [];\r\n  private streamProgressHandlers: Array<(snapshotsSent: number) => void> = [];\r\n  private streamCompleteHandlers: Array<(channel: WsChannel, coin: string, snapshotsSent: number) => void> = [];\r\n  private orderbookHandlers: Array<(coin: string, data: OrderBook) => void> = [];\r\n  private tradesHandlers: Array<(coin: string, data: Trade[]) => void> = [];\r\n\r\n  constructor(options: WsOptions) {\r\n    this.options = {\r\n      apiKey: options.apiKey,\r\n      wsUrl: options.wsUrl ?? DEFAULT_WS_URL,\r\n      autoReconnect: options.autoReconnect ?? true,\r\n      reconnectDelay: options.reconnectDelay ?? DEFAULT_RECONNECT_DELAY,\r\n      maxReconnectAttempts: options.maxReconnectAttempts ?? DEFAULT_MAX_RECONNECT_ATTEMPTS,\r\n      pingInterval: options.pingInterval ?? DEFAULT_PING_INTERVAL,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Connect to the WebSocket server\r\n   */\r\n  connect(handlers?: WsEventHandlers): void {\r\n    if (handlers) {\r\n      this.handlers = handlers;\r\n    }\r\n\r\n    this.setState('connecting');\r\n\r\n    const url = `${this.options.wsUrl}?apiKey=${encodeURIComponent(this.options.apiKey)}`;\r\n    this.ws = new WebSocket(url);\r\n\r\n    this.ws.onopen = () => {\r\n      this.reconnectAttempts = 0;\r\n      this.setState('connected');\r\n      this.startPing();\r\n      this.resubscribe();\r\n      this.handlers.onOpen?.();\r\n    };\r\n\r\n    this.ws.onclose = (event) => {\r\n      this.stopPing();\r\n      this.handlers.onClose?.(event.code, event.reason);\r\n\r\n      if (this.options.autoReconnect && this.state !== 'disconnected') {\r\n        this.scheduleReconnect();\r\n      } else {\r\n        this.setState('disconnected');\r\n      }\r\n    };\r\n\r\n    this.ws.onerror = () => {\r\n      const error = new Error('WebSocket connection error');\r\n      this.handlers.onError?.(error);\r\n    };\r\n\r\n    this.ws.onmessage = (event) => {\r\n      try {\r\n        const message = JSON.parse(event.data) as WsServerMessage;\r\n        this.handleMessage(message);\r\n      } catch {\r\n        // Ignore parse errors for malformed messages\r\n      }\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Disconnect from the WebSocket server\r\n   */\r\n  disconnect(): void {\r\n    this.setState('disconnected');\r\n    this.stopPing();\r\n    this.clearReconnectTimer();\r\n\r\n    if (this.ws) {\r\n      this.ws.close(1000, 'Client disconnect');\r\n      this.ws = null;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Subscribe to a channel\r\n   */\r\n  subscribe(channel: WsChannel, coin?: string): void {\r\n    const key = this.subscriptionKey(channel, coin);\r\n    this.subscriptions.add(key);\r\n\r\n    if (this.isConnected()) {\r\n      this.send({ op: 'subscribe', channel, coin });\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Subscribe to order book updates for a coin\r\n   */\r\n  subscribeOrderbook(coin: string): void {\r\n    this.subscribe('orderbook', coin);\r\n  }\r\n\r\n  /**\r\n   * Subscribe to trades for a coin\r\n   */\r\n  subscribeTrades(coin: string): void {\r\n    this.subscribe('trades', coin);\r\n  }\r\n\r\n  /**\r\n   * Subscribe to ticker updates for a coin\r\n   */\r\n  subscribeTicker(coin: string): void {\r\n    this.subscribe('ticker', coin);\r\n  }\r\n\r\n  /**\r\n   * Subscribe to all tickers\r\n   */\r\n  subscribeAllTickers(): void {\r\n    this.subscribe('all_tickers');\r\n  }\r\n\r\n  /**\r\n   * Unsubscribe from a channel\r\n   */\r\n  unsubscribe(channel: WsChannel, coin?: string): void {\r\n    const key = this.subscriptionKey(channel, coin);\r\n    this.subscriptions.delete(key);\r\n\r\n    if (this.isConnected()) {\r\n      this.send({ op: 'unsubscribe', channel, coin });\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Unsubscribe from order book updates for a coin\r\n   */\r\n  unsubscribeOrderbook(coin: string): void {\r\n    this.unsubscribe('orderbook', coin);\r\n  }\r\n\r\n  /**\r\n   * Unsubscribe from trades for a coin\r\n   */\r\n  unsubscribeTrades(coin: string): void {\r\n    this.unsubscribe('trades', coin);\r\n  }\r\n\r\n  /**\r\n   * Unsubscribe from ticker updates for a coin\r\n   */\r\n  unsubscribeTicker(coin: string): void {\r\n    this.unsubscribe('ticker', coin);\r\n  }\r\n\r\n  /**\r\n   * Unsubscribe from all tickers\r\n   */\r\n  unsubscribeAllTickers(): void {\r\n    this.unsubscribe('all_tickers');\r\n  }\r\n\r\n  // ==========================================================================\r\n  // Historical Replay (Option B) - Like Tardis.dev\r\n  // ==========================================================================\r\n\r\n  /**\r\n   * Start historical replay with timing preserved\r\n   *\r\n   * @param channel - Data channel to replay\r\n   * @param coin - Trading pair (e.g., 'BTC', 'ETH')\r\n   * @param options - Replay options\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * ws.replay('orderbook', 'BTC', {\r\n   *   start: Date.now() - 86400000, // 24 hours ago\r\n   *   speed: 10 // 10x faster than real-time\r\n   * });\r\n   * ```\r\n   */\r\n  replay(\r\n    channel: WsChannel,\r\n    coin: string,\r\n    options: {\r\n      start: number;\r\n      end?: number;\r\n      speed?: number;\r\n    }\r\n  ): void {\r\n    this.send({\r\n      op: 'replay',\r\n      channel,\r\n      coin,\r\n      start: options.start,\r\n      end: options.end,\r\n      speed: options.speed ?? 1,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Pause the current replay\r\n   */\r\n  replayPause(): void {\r\n    this.send({ op: 'replay.pause' });\r\n  }\r\n\r\n  /**\r\n   * Resume a paused replay\r\n   */\r\n  replayResume(): void {\r\n    this.send({ op: 'replay.resume' });\r\n  }\r\n\r\n  /**\r\n   * Seek to a specific timestamp in the replay\r\n   * @param timestamp - Unix timestamp in milliseconds\r\n   */\r\n  replaySeek(timestamp: number): void {\r\n    this.send({ op: 'replay.seek', timestamp });\r\n  }\r\n\r\n  /**\r\n   * Stop the current replay\r\n   */\r\n  replayStop(): void {\r\n    this.send({ op: 'replay.stop' });\r\n  }\r\n\r\n  // ==========================================================================\r\n  // Bulk Streaming (Option D) - Like Databento\r\n  // ==========================================================================\r\n\r\n  /**\r\n   * Start bulk streaming for fast data download\r\n   *\r\n   * @param channel - Data channel to stream\r\n   * @param coin - Trading pair (e.g., 'BTC', 'ETH')\r\n   * @param options - Stream options\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * ws.stream('orderbook', 'ETH', {\r\n   *   start: Date.now() - 3600000, // 1 hour ago\r\n   *   end: Date.now(),\r\n   *   batchSize: 1000\r\n   * });\r\n   * ```\r\n   */\r\n  stream(\r\n    channel: WsChannel,\r\n    coin: string,\r\n    options: {\r\n      start: number;\r\n      end: number;\r\n      batchSize?: number;\r\n    }\r\n  ): void {\r\n    this.send({\r\n      op: 'stream',\r\n      channel,\r\n      coin,\r\n      start: options.start,\r\n      end: options.end,\r\n      batch_size: options.batchSize ?? 1000,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Stop the current bulk stream\r\n   */\r\n  streamStop(): void {\r\n    this.send({ op: 'stream.stop' });\r\n  }\r\n\r\n  // ==========================================================================\r\n  // Event Handlers for Replay/Stream\r\n  // ==========================================================================\r\n\r\n  /**\r\n   * Handle historical data points (replay mode)\r\n   */\r\n  onHistoricalData<T = unknown>(\r\n    handler: (coin: string, timestamp: number, data: T) => void\r\n  ): void {\r\n    this.historicalDataHandlers.push(handler as (coin: string, timestamp: number, data: unknown) => void);\r\n  }\r\n\r\n  /**\r\n   * Handle batched data (bulk stream mode)\r\n   */\r\n  onBatch<T = unknown>(\r\n    handler: (coin: string, records: Array<{ timestamp: number; data: T }>) => void\r\n  ): void {\r\n    this.batchHandlers.push(handler as (coin: string, records: Array<{ timestamp: number; data: unknown }>) => void);\r\n  }\r\n\r\n  /**\r\n   * Handle replay started event\r\n   */\r\n  onReplayStart(\r\n    handler: (channel: WsChannel, coin: string, start: number, end: number, speed: number) => void\r\n  ): void {\r\n    this.replayStartHandlers.push(handler);\r\n  }\r\n\r\n  /**\r\n   * Handle replay completed event\r\n   */\r\n  onReplayComplete(\r\n    handler: (channel: WsChannel, coin: string, snapshotsSent: number) => void\r\n  ): void {\r\n    this.replayCompleteHandlers.push(handler);\r\n  }\r\n\r\n  /**\r\n   * Handle stream started event\r\n   */\r\n  onStreamStart(\r\n    handler: (channel: WsChannel, coin: string, start: number, end: number) => void\r\n  ): void {\r\n    this.streamStartHandlers.push(handler);\r\n  }\r\n\r\n  /**\r\n   * Handle stream progress event\r\n   */\r\n  onStreamProgress(\r\n    handler: (snapshotsSent: number) => void\r\n  ): void {\r\n    this.streamProgressHandlers.push(handler);\r\n  }\r\n\r\n  /**\r\n   * Handle stream completed event\r\n   */\r\n  onStreamComplete(\r\n    handler: (channel: WsChannel, coin: string, snapshotsSent: number) => void\r\n  ): void {\r\n    this.streamCompleteHandlers.push(handler);\r\n  }\r\n\r\n  /**\r\n   * Get current connection state\r\n   */\r\n  getState(): WsConnectionState {\r\n    return this.state;\r\n  }\r\n\r\n  /**\r\n   * Check if connected\r\n   */\r\n  isConnected(): boolean {\r\n    return this.ws?.readyState === WebSocket.OPEN;\r\n  }\r\n\r\n  /**\r\n   * Set event handlers after construction\r\n   */\r\n  on<K extends keyof WsEventHandlers>(event: K, handler: WsEventHandlers[K]): void {\r\n    this.handlers[event] = handler;\r\n  }\r\n\r\n  /**\r\n   * Helper to handle typed orderbook data\r\n   */\r\n  onOrderbook(handler: (coin: string, data: OrderBook) => void): void {\r\n    this.orderbookHandlers.push(handler);\r\n  }\r\n\r\n  /**\r\n   * Helper to handle typed trade data\r\n   */\r\n  onTrades(handler: (coin: string, data: Trade[]) => void): void {\r\n    this.tradesHandlers.push(handler);\r\n  }\r\n\r\n  // Private methods\r\n\r\n  private send(message: WsClientMessage): void {\r\n    if (this.ws?.readyState === WebSocket.OPEN) {\r\n      this.ws.send(JSON.stringify(message));\r\n    }\r\n  }\r\n\r\n  private setState(state: WsConnectionState): void {\r\n    this.state = state;\r\n    this.handlers.onStateChange?.(state);\r\n  }\r\n\r\n  private startPing(): void {\r\n    this.stopPing();\r\n    this.pingTimer = setInterval(() => {\r\n      this.send({ op: 'ping' });\r\n    }, this.options.pingInterval);\r\n  }\r\n\r\n  private stopPing(): void {\r\n    if (this.pingTimer) {\r\n      clearInterval(this.pingTimer);\r\n      this.pingTimer = null;\r\n    }\r\n  }\r\n\r\n  private subscriptionKey(channel: WsChannel, coin?: string): string {\r\n    return coin ? `${channel}:${coin}` : channel;\r\n  }\r\n\r\n  private resubscribe(): void {\r\n    for (const key of this.subscriptions) {\r\n      const [channel, coin] = key.split(':') as [WsChannel, string | undefined];\r\n      this.send({ op: 'subscribe', channel, coin });\r\n    }\r\n  }\r\n\r\n  private scheduleReconnect(): void {\r\n    if (this.reconnectAttempts >= this.options.maxReconnectAttempts) {\r\n      this.setState('disconnected');\r\n      return;\r\n    }\r\n\r\n    this.setState('reconnecting');\r\n    this.reconnectAttempts++;\r\n\r\n    const delay = this.options.reconnectDelay * Math.pow(2, this.reconnectAttempts - 1);\r\n\r\n    this.reconnectTimer = setTimeout(() => {\r\n      this.connect();\r\n    }, delay);\r\n  }\r\n\r\n  private clearReconnectTimer(): void {\r\n    if (this.reconnectTimer) {\r\n      clearTimeout(this.reconnectTimer);\r\n      this.reconnectTimer = null;\r\n    }\r\n  }\r\n\r\n  private handleMessage(message: WsServerMessage): void {\r\n    // Call the generic onMessage handler first\r\n    this.handlers.onMessage?.(message);\r\n\r\n    // Dispatch to typed handlers based on message type\r\n    switch (message.type) {\r\n      case 'historical_data': {\r\n        const msg = message as WsHistoricalData;\r\n        for (const handler of this.historicalDataHandlers) {\r\n          handler(msg.coin, msg.timestamp, msg.data);\r\n        }\r\n        break;\r\n      }\r\n      case 'historical_batch': {\r\n        const msg = message as WsHistoricalBatch;\r\n        for (const handler of this.batchHandlers) {\r\n          handler(msg.coin, msg.data as Array<{ timestamp: number; data: unknown }>);\r\n        }\r\n        break;\r\n      }\r\n      case 'replay_started': {\r\n        const msg = message as WsReplayStarted;\r\n        for (const handler of this.replayStartHandlers) {\r\n          handler(msg.channel, msg.coin, msg.start, msg.end, msg.speed);\r\n        }\r\n        break;\r\n      }\r\n      case 'replay_completed': {\r\n        const msg = message as WsReplayCompleted;\r\n        for (const handler of this.replayCompleteHandlers) {\r\n          handler(msg.channel, msg.coin, msg.snapshots_sent);\r\n        }\r\n        break;\r\n      }\r\n      case 'stream_started': {\r\n        const msg = message as WsStreamStarted;\r\n        for (const handler of this.streamStartHandlers) {\r\n          handler(msg.channel, msg.coin, msg.start, msg.end);\r\n        }\r\n        break;\r\n      }\r\n      case 'stream_progress': {\r\n        const msg = message as WsStreamProgress;\r\n        for (const handler of this.streamProgressHandlers) {\r\n          handler(msg.snapshots_sent);\r\n        }\r\n        break;\r\n      }\r\n      case 'stream_completed': {\r\n        const msg = message as WsStreamCompleted;\r\n        for (const handler of this.streamCompleteHandlers) {\r\n          handler(msg.channel, msg.coin, msg.snapshots_sent);\r\n        }\r\n        break;\r\n      }\r\n      case 'data': {\r\n        if (message.channel === 'orderbook') {\r\n          // Transform raw Hyperliquid format to SDK OrderBook type\r\n          const orderbook = transformOrderbook(message.coin, message.data as Record<string, unknown>);\r\n          for (const handler of this.orderbookHandlers) {\r\n            handler(message.coin, orderbook);\r\n          }\r\n        } else if (message.channel === 'trades') {\r\n          // Transform raw Hyperliquid format to SDK Trade type\r\n          const trades = transformTrades(message.coin, message.data);\r\n          for (const handler of this.tradesHandlers) {\r\n            handler(message.coin, trades);\r\n          }\r\n        }\r\n        break;\r\n      }\r\n    }\r\n  }\r\n}\r\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/types.ts","../src/http.ts","../src/schemas.ts","../src/resources/orderbook.ts","../src/resources/trades.ts","../src/resources/instruments.ts","../src/resources/funding.ts","../src/resources/openinterest.ts","../src/client.ts","../src/websocket.ts"],"sourcesContent":["/**\r\n * Configuration options for the 0xarchive client\r\n */\r\nexport interface ClientOptions {\r\n  /** Your 0xarchive API key */\r\n  apiKey: string;\r\n  /** Base URL for the API (defaults to https://api.0xarchive.io) */\r\n  baseUrl?: string;\r\n  /** Request timeout in milliseconds (defaults to 30000) */\r\n  timeout?: number;\r\n  /** Enable runtime validation of API responses using Zod schemas (defaults to false) */\r\n  validate?: boolean;\r\n}\r\n\r\n/**\r\n * Response metadata\r\n */\r\nexport interface ApiMeta {\r\n  /** Number of records returned */\r\n  count: number;\r\n  /** Cursor for next page (if available) */\r\n  next_cursor?: string;\r\n  /** Unique request ID for debugging */\r\n  request_id: string;\r\n}\r\n\r\n/**\r\n * Standard API response wrapper\r\n */\r\nexport interface ApiResponse<T> {\r\n  success: boolean;\r\n  data: T;\r\n  meta: ApiMeta;\r\n}\r\n\r\n/**\r\n * Pagination parameters for list endpoints\r\n * @deprecated Use cursor-based pagination instead (CursorPaginationParams)\r\n */\r\nexport interface PaginationParams {\r\n  /** Maximum number of results to return */\r\n  limit?: number;\r\n  /** @deprecated Use cursor instead. Number of results to skip */\r\n  offset?: number;\r\n}\r\n\r\n/**\r\n * Time range parameters for historical queries\r\n * @deprecated Use CursorPaginationParams for better performance with large datasets\r\n */\r\nexport interface TimeRangeParams extends PaginationParams {\r\n  /** Start timestamp (Unix ms or ISO string) - REQUIRED for history endpoints */\r\n  start: number | string;\r\n  /** End timestamp (Unix ms or ISO string) - REQUIRED for history endpoints */\r\n  end: number | string;\r\n}\r\n\r\n// =============================================================================\r\n// Order Book Types\r\n// =============================================================================\r\n\r\n/**\r\n * A price level in the order book\r\n */\r\nexport interface PriceLevel {\r\n  /** Price at this level */\r\n  px: string;\r\n  /** Total size at this price level */\r\n  sz: string;\r\n  /** Number of orders at this level */\r\n  n: number;\r\n}\r\n\r\n/**\r\n * Order book snapshot\r\n */\r\nexport interface OrderBook {\r\n  /** Trading pair symbol (e.g., BTC, ETH) */\r\n  coin: string;\r\n  /** Snapshot timestamp (UTC) */\r\n  timestamp: string;\r\n  /** Bid price levels (best bid first) */\r\n  bids: PriceLevel[];\r\n  /** Ask price levels (best ask first) */\r\n  asks: PriceLevel[];\r\n  /** Mid price (best bid + best ask) / 2 */\r\n  mid_price?: string;\r\n  /** Spread in absolute terms (best ask - best bid) */\r\n  spread?: string;\r\n  /** Spread in basis points */\r\n  spread_bps?: string;\r\n}\r\n\r\nexport interface GetOrderBookParams {\r\n  /** Timestamp to get order book at (Unix ms or ISO string) */\r\n  timestamp?: number | string;\r\n  /** Number of price levels to return per side */\r\n  depth?: number;\r\n}\r\n\r\nexport interface OrderBookHistoryParams extends TimeRangeParams {\r\n  /** Number of price levels to return per side */\r\n  depth?: number;\r\n}\r\n\r\n// =============================================================================\r\n// Trade/Fill Types\r\n// =============================================================================\r\n\r\n/** Trade side: 'A' (ask/sell) or 'B' (bid/buy) */\r\nexport type TradeSide = 'A' | 'B';\r\n\r\n/** Position direction */\r\nexport type TradeDirection = 'Open Long' | 'Open Short' | 'Close Long' | 'Close Short';\r\n\r\n/** Data source: 's3' (historical), 'api' (REST backfill), 'ws' (websocket), 'live' (real-time ingestion) */\r\nexport type DataSource = 's3' | 'ws' | 'api' | 'live';\r\n\r\n/**\r\n * Trade/fill record with full execution details\r\n */\r\nexport interface Trade {\r\n  /** Trading pair symbol */\r\n  coin: string;\r\n  /** Trade side: 'A' (ask/sell) or 'B' (bid/buy) */\r\n  side: TradeSide;\r\n  /** Execution price */\r\n  price: string;\r\n  /** Trade size */\r\n  size: string;\r\n  /** Execution timestamp (UTC) */\r\n  timestamp: string;\r\n  /** Blockchain transaction hash */\r\n  tx_hash?: string;\r\n  /** Unique trade ID */\r\n  trade_id?: number;\r\n  /** Associated order ID */\r\n  order_id?: number;\r\n  /** True if taker (crossed the spread), false if maker */\r\n  crossed?: boolean;\r\n  /** Trading fee amount */\r\n  fee?: string;\r\n  /** Fee denomination (e.g., USDC) */\r\n  fee_token?: string;\r\n  /** Realized PnL if closing a position */\r\n  closed_pnl?: string;\r\n  /** Position direction */\r\n  direction?: TradeDirection;\r\n  /** Position size before this trade */\r\n  start_position?: string;\r\n  /** Data source */\r\n  source?: DataSource;\r\n  /** User's wallet address (for fill-level data from REST API) */\r\n  user_address?: string;\r\n  /** Maker's wallet address (for market-level WebSocket trades) */\r\n  maker_address?: string;\r\n  /** Taker's wallet address (for market-level WebSocket trades) */\r\n  taker_address?: string;\r\n}\r\n\r\n/**\r\n * @deprecated Use GetTradesCursorParams instead for better performance with large datasets\r\n */\r\nexport interface GetTradesParams extends TimeRangeParams {\r\n  /** Filter by side */\r\n  side?: TradeSide;\r\n}\r\n\r\n/**\r\n * Cursor-based pagination parameters for trades (recommended)\r\n * More efficient than offset-based pagination for large datasets.\r\n * The cursor is a timestamp - use the `nextCursor` from the response to get the next page.\r\n */\r\nexport interface CursorPaginationParams {\r\n  /** Start timestamp (Unix ms or ISO string) - REQUIRED */\r\n  start: number | string;\r\n  /** End timestamp (Unix ms or ISO string) - REQUIRED */\r\n  end: number | string;\r\n  /** Cursor from previous response's nextCursor (timestamp). If not provided, starts from the beginning of the range. */\r\n  cursor?: number | string;\r\n  /** Maximum number of results to return (default: 100, max: 1000) */\r\n  limit?: number;\r\n}\r\n\r\n/**\r\n * Parameters for getting trades with cursor-based pagination (recommended)\r\n */\r\nexport interface GetTradesCursorParams extends CursorPaginationParams {\r\n  /** Filter by side */\r\n  side?: TradeSide;\r\n}\r\n\r\n/**\r\n * Response with cursor for pagination\r\n */\r\nexport interface CursorResponse<T> {\r\n  data: T;\r\n  /** Cursor for next page (use as cursor parameter) */\r\n  nextCursor?: string;\r\n}\r\n\r\n// =============================================================================\r\n// Instruments Types\r\n// =============================================================================\r\n\r\n/** Instrument type */\r\nexport type InstrumentType = 'perp' | 'spot';\r\n\r\n/**\r\n * Trading instrument metadata\r\n */\r\nexport interface Instrument {\r\n  /** Instrument symbol (e.g., BTC) */\r\n  name: string;\r\n  /** Size decimal precision */\r\n  szDecimals: number;\r\n  /** Maximum leverage allowed */\r\n  maxLeverage?: number;\r\n  /** If true, only isolated margin mode is allowed */\r\n  onlyIsolated?: boolean;\r\n  /** Type of instrument */\r\n  instrumentType?: InstrumentType;\r\n  /** Whether the instrument is currently tradeable */\r\n  isActive: boolean;\r\n}\r\n\r\n// =============================================================================\r\n// Funding Types\r\n// =============================================================================\r\n\r\n/**\r\n * Funding rate record\r\n */\r\nexport interface FundingRate {\r\n  /** Trading pair symbol */\r\n  coin: string;\r\n  /** Funding timestamp (UTC) */\r\n  timestamp: string;\r\n  /** Funding rate as decimal (e.g., 0.0001 = 0.01%) */\r\n  funding_rate: string;\r\n  /** Premium component of funding rate */\r\n  premium?: string;\r\n}\r\n\r\n// =============================================================================\r\n// Open Interest Types\r\n// =============================================================================\r\n\r\n/**\r\n * Open interest snapshot with market context\r\n */\r\nexport interface OpenInterest {\r\n  /** Trading pair symbol */\r\n  coin: string;\r\n  /** Snapshot timestamp (UTC) */\r\n  timestamp: string;\r\n  /** Total open interest in contracts */\r\n  open_interest: string;\r\n  /** Mark price used for liquidations */\r\n  mark_price?: string;\r\n  /** Oracle price from external feed */\r\n  oracle_price?: string;\r\n  /** 24-hour notional volume */\r\n  day_ntl_volume?: string;\r\n  /** Price 24 hours ago */\r\n  prev_day_price?: string;\r\n  /** Current mid price */\r\n  mid_price?: string;\r\n  /** Impact bid price for liquidations */\r\n  impact_bid_price?: string;\r\n  /** Impact ask price for liquidations */\r\n  impact_ask_price?: string;\r\n}\r\n\r\n// =============================================================================\r\n// WebSocket Types\r\n// =============================================================================\r\n\r\n/** WebSocket channel types. Note: ticker/all_tickers are real-time only. */\r\nexport type WsChannel = 'orderbook' | 'trades' | 'ticker' | 'all_tickers';\r\n\r\n/** Subscribe message from client */\r\nexport interface WsSubscribe {\r\n  op: 'subscribe';\r\n  channel: WsChannel;\r\n  coin?: string;\r\n}\r\n\r\n/** Unsubscribe message from client */\r\nexport interface WsUnsubscribe {\r\n  op: 'unsubscribe';\r\n  channel: WsChannel;\r\n  coin?: string;\r\n}\r\n\r\n/** Ping message from client */\r\nexport interface WsPing {\r\n  op: 'ping';\r\n}\r\n\r\n/** Replay message from client - replays historical data with timing preserved */\r\nexport interface WsReplay {\r\n  op: 'replay';\r\n  channel: WsChannel;\r\n  coin?: string;\r\n  /** Start timestamp (Unix ms) */\r\n  start: number;\r\n  /** End timestamp (Unix ms, defaults to now) */\r\n  end?: number;\r\n  /** Playback speed multiplier (1 = real-time, 10 = 10x faster) */\r\n  speed?: number;\r\n}\r\n\r\n/** Replay control messages */\r\nexport interface WsReplayPause { op: 'replay.pause'; }\r\nexport interface WsReplayResume { op: 'replay.resume'; }\r\nexport interface WsReplaySeek { op: 'replay.seek'; timestamp: number; }\r\nexport interface WsReplayStop { op: 'replay.stop'; }\r\n\r\n/** Stream message from client - bulk download historical data */\r\nexport interface WsStream {\r\n  op: 'stream';\r\n  channel: WsChannel;\r\n  coin?: string;\r\n  /** Start timestamp (Unix ms) */\r\n  start: number;\r\n  /** End timestamp (Unix ms) */\r\n  end: number;\r\n  /** Batch size (records per message) */\r\n  batch_size?: number;\r\n}\r\n\r\n/** Stream control messages */\r\nexport interface WsStreamStop { op: 'stream.stop'; }\r\n\r\n/** Client message union type */\r\nexport type WsClientMessage =\r\n  | WsSubscribe\r\n  | WsUnsubscribe\r\n  | WsPing\r\n  | WsReplay\r\n  | WsReplayPause\r\n  | WsReplayResume\r\n  | WsReplaySeek\r\n  | WsReplayStop\r\n  | WsStream\r\n  | WsStreamStop;\r\n\r\n/** Subscription confirmed from server */\r\nexport interface WsSubscribed {\r\n  type: 'subscribed';\r\n  channel: WsChannel;\r\n  coin?: string;\r\n}\r\n\r\n/** Unsubscription confirmed from server */\r\nexport interface WsUnsubscribed {\r\n  type: 'unsubscribed';\r\n  channel: WsChannel;\r\n  coin?: string;\r\n}\r\n\r\n/** Pong response from server */\r\nexport interface WsPong {\r\n  type: 'pong';\r\n}\r\n\r\n/** Error from server */\r\nexport interface WsError {\r\n  type: 'error';\r\n  message: string;\r\n}\r\n\r\n/** Data message from server (real-time) */\r\nexport interface WsData<T = unknown> {\r\n  type: 'data';\r\n  channel: WsChannel;\r\n  coin: string;\r\n  data: T;\r\n}\r\n\r\n/** Replay started response */\r\nexport interface WsReplayStarted {\r\n  type: 'replay_started';\r\n  channel: WsChannel;\r\n  coin: string;\r\n  /** Start timestamp in milliseconds */\r\n  start: number;\r\n  /** End timestamp in milliseconds */\r\n  end: number;\r\n  /** Playback speed multiplier */\r\n  speed: number;\r\n}\r\n\r\n/** Replay paused response */\r\nexport interface WsReplayPaused {\r\n  type: 'replay_paused';\r\n  current_timestamp: number;\r\n}\r\n\r\n/** Replay resumed response */\r\nexport interface WsReplayResumed {\r\n  type: 'replay_resumed';\r\n  current_timestamp: number;\r\n}\r\n\r\n/** Replay completed response */\r\nexport interface WsReplayCompleted {\r\n  type: 'replay_completed';\r\n  channel: WsChannel;\r\n  coin: string;\r\n  snapshots_sent: number;\r\n}\r\n\r\n/** Replay stopped response */\r\nexport interface WsReplayStopped {\r\n  type: 'replay_stopped';\r\n}\r\n\r\n/** Historical data point (replay mode) */\r\nexport interface WsHistoricalData<T = unknown> {\r\n  type: 'historical_data';\r\n  channel: WsChannel;\r\n  coin: string;\r\n  timestamp: number;\r\n  data: T;\r\n}\r\n\r\n/** Stream started response */\r\nexport interface WsStreamStarted {\r\n  type: 'stream_started';\r\n  channel: WsChannel;\r\n  coin: string;\r\n  /** Start timestamp in milliseconds */\r\n  start: number;\r\n  /** End timestamp in milliseconds */\r\n  end: number;\r\n}\r\n\r\n/** Stream progress response (sent periodically during streaming) */\r\nexport interface WsStreamProgress {\r\n  type: 'stream_progress';\r\n  snapshots_sent: number;\r\n}\r\n\r\n/** A record with timestamp for batched data */\r\nexport interface TimestampedRecord<T = unknown> {\r\n  timestamp: number;\r\n  data: T;\r\n}\r\n\r\n/** Batch of historical data (bulk streaming) */\r\nexport interface WsHistoricalBatch<T = unknown> {\r\n  type: 'historical_batch';\r\n  channel: WsChannel;\r\n  coin: string;\r\n  data: TimestampedRecord<T>[];\r\n}\r\n\r\n/** Stream completed response */\r\nexport interface WsStreamCompleted {\r\n  type: 'stream_completed';\r\n  channel: WsChannel;\r\n  coin: string;\r\n  snapshots_sent: number;\r\n}\r\n\r\n/** Stream stopped response */\r\nexport interface WsStreamStopped {\r\n  type: 'stream_stopped';\r\n  snapshots_sent: number;\r\n}\r\n\r\n/** Server message union type */\r\nexport type WsServerMessage =\r\n  | WsSubscribed\r\n  | WsUnsubscribed\r\n  | WsPong\r\n  | WsError\r\n  | WsData\r\n  | WsReplayStarted\r\n  | WsReplayPaused\r\n  | WsReplayResumed\r\n  | WsReplayCompleted\r\n  | WsReplayStopped\r\n  | WsHistoricalData\r\n  | WsStreamStarted\r\n  | WsStreamProgress\r\n  | WsHistoricalBatch\r\n  | WsStreamCompleted\r\n  | WsStreamStopped;\r\n\r\n/**\r\n * WebSocket connection options.\r\n *\r\n * The server sends WebSocket ping frames every 30 seconds and will disconnect\r\n * idle connections after 60 seconds. The SDK automatically handles keep-alive\r\n * by sending application-level pings at the configured interval.\r\n */\r\nexport interface WsOptions {\r\n  /** API key for authentication */\r\n  apiKey: string;\r\n  /** WebSocket URL (defaults to wss://api.0xarchive.io/ws) */\r\n  wsUrl?: string;\r\n  /** Auto-reconnect on disconnect (defaults to true) */\r\n  autoReconnect?: boolean;\r\n  /** Reconnect delay in ms (defaults to 1000) */\r\n  reconnectDelay?: number;\r\n  /** Maximum reconnect attempts (defaults to 10) */\r\n  maxReconnectAttempts?: number;\r\n  /** Ping interval in ms to keep connection alive (defaults to 30000). Server disconnects after 60s idle. */\r\n  pingInterval?: number;\r\n}\r\n\r\n/** WebSocket connection state */\r\nexport type WsConnectionState = 'connecting' | 'connected' | 'disconnected' | 'reconnecting';\r\n\r\n/** WebSocket event handlers */\r\nexport interface WsEventHandlers {\r\n  onOpen?: () => void;\r\n  onClose?: (code: number, reason: string) => void;\r\n  onError?: (error: Error) => void;\r\n  onMessage?: (message: WsServerMessage) => void;\r\n  onStateChange?: (state: WsConnectionState) => void;\r\n}\r\n\r\n// =============================================================================\r\n// Error Types\r\n// =============================================================================\r\n\r\n/**\r\n * API error response\r\n */\r\nexport interface ApiError {\r\n  code: number;\r\n  error: string;\r\n}\r\n\r\n/**\r\n * SDK error class\r\n */\r\nexport class OxArchiveError extends Error {\r\n  code: number;\r\n  requestId?: string;\r\n\r\n  constructor(message: string, code: number, requestId?: string) {\r\n    super(message);\r\n    this.name = 'OxArchiveError';\r\n    this.code = code;\r\n    this.requestId = requestId;\r\n  }\r\n}\r\n\r\n/** Timestamp can be Unix ms (number), ISO string, or Date object */\r\nexport type Timestamp = number | string | Date;\r\n","import type { z } from 'zod';\r\nimport type { ApiResponse, ApiError } from './types';\r\nimport { OxArchiveError } from './types';\r\n\r\nexport interface HttpClientOptions {\r\n  baseUrl: string;\r\n  apiKey: string;\r\n  timeout: number;\r\n  /** Enable runtime validation of API responses using Zod schemas (default: false) */\r\n  validate?: boolean;\r\n}\r\n\r\n/**\r\n * Internal HTTP client for making API requests\r\n */\r\nexport class HttpClient {\r\n  private baseUrl: string;\r\n  private apiKey: string;\r\n  private timeout: number;\r\n  private validate: boolean;\r\n\r\n  constructor(options: HttpClientOptions) {\r\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '');\r\n    this.apiKey = options.apiKey;\r\n    this.timeout = options.timeout;\r\n    this.validate = options.validate ?? false;\r\n  }\r\n\r\n  /** Whether validation is enabled */\r\n  get validationEnabled(): boolean {\r\n    return this.validate;\r\n  }\r\n\r\n  /**\r\n   * Make a GET request to the API\r\n   *\r\n   * @param path - API endpoint path\r\n   * @param params - Query parameters\r\n   * @param schema - Optional Zod schema for validation (used when validation is enabled)\r\n   */\r\n  async get<T>(\r\n    path: string,\r\n    params?: Record<string, unknown>,\r\n    schema?: z.ZodType<T>\r\n  ): Promise<T> {\r\n    const url = new URL(`${this.baseUrl}${path}`);\r\n\r\n    if (params) {\r\n      for (const [key, value] of Object.entries(params)) {\r\n        if (value !== undefined && value !== null) {\r\n          url.searchParams.set(key, String(value));\r\n        }\r\n      }\r\n    }\r\n\r\n    const controller = new AbortController();\r\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\r\n\r\n    try {\r\n      const response = await fetch(url.toString(), {\r\n        method: 'GET',\r\n        headers: {\r\n          'X-API-Key': this.apiKey,\r\n          'Content-Type': 'application/json',\r\n        },\r\n        signal: controller.signal,\r\n      });\r\n\r\n      clearTimeout(timeoutId);\r\n\r\n      const data = await response.json();\r\n\r\n      if (!response.ok) {\r\n        const error = data as ApiError;\r\n        throw new OxArchiveError(\r\n          error.error || `Request failed with status ${response.status}`,\r\n          response.status,\r\n          (data as ApiResponse<unknown>).meta?.request_id\r\n        );\r\n      }\r\n\r\n      // Validate response if validation is enabled and schema is provided\r\n      if (this.validate && schema) {\r\n        const result = schema.safeParse(data);\r\n        if (!result.success) {\r\n          throw new OxArchiveError(\r\n            `Response validation failed: ${result.error.message}`,\r\n            422,\r\n            (data as ApiResponse<unknown>).meta?.request_id\r\n          );\r\n        }\r\n        return result.data;\r\n      }\r\n\r\n      return data as T;\r\n    } catch (error) {\r\n      clearTimeout(timeoutId);\r\n\r\n      if (error instanceof OxArchiveError) {\r\n        throw error;\r\n      }\r\n\r\n      if (error instanceof Error && error.name === 'AbortError') {\r\n        throw new OxArchiveError(`Request timeout after ${this.timeout}ms`, 408);\r\n      }\r\n\r\n      throw new OxArchiveError(\r\n        error instanceof Error ? error.message : 'Unknown error',\r\n        500\r\n      );\r\n    }\r\n  }\r\n}\r\n","/**\r\n * Zod schemas for runtime validation of API responses\r\n *\r\n * @example\r\n * ```typescript\r\n * import { OrderBookSchema, TradeSchema } from '@0xarchive/sdk';\r\n *\r\n * // Validate data manually\r\n * const result = OrderBookSchema.safeParse(data);\r\n * if (result.success) {\r\n *   console.log(result.data.mid_price);\r\n * } else {\r\n *   console.error(result.error);\r\n * }\r\n * ```\r\n */\r\n\r\nimport { z } from 'zod';\r\n\r\n// =============================================================================\r\n// Base Schemas\r\n// =============================================================================\r\n\r\nexport const ApiMetaSchema = z.object({\r\n  count: z.number(),\r\n  next_cursor: z.string().optional(),\r\n  request_id: z.string(),\r\n});\r\n\r\nexport const ApiResponseSchema = <T extends z.ZodTypeAny>(dataSchema: T) =>\r\n  z.object({\r\n    success: z.boolean(),\r\n    data: dataSchema,\r\n    meta: ApiMetaSchema,\r\n  });\r\n\r\n// =============================================================================\r\n// Order Book Schemas\r\n// =============================================================================\r\n\r\nexport const PriceLevelSchema = z.object({\r\n  px: z.string(),\r\n  sz: z.string(),\r\n  n: z.number(),\r\n});\r\n\r\nexport const OrderBookSchema = z.object({\r\n  coin: z.string(),\r\n  timestamp: z.string(),\r\n  bids: z.array(PriceLevelSchema),\r\n  asks: z.array(PriceLevelSchema),\r\n  mid_price: z.string().optional(),\r\n  spread: z.string().optional(),\r\n  spread_bps: z.string().optional(),\r\n});\r\n\r\n// =============================================================================\r\n// Trade/Fill Schemas\r\n// =============================================================================\r\n\r\nexport const TradeSideSchema = z.enum(['A', 'B']);\r\n\r\nexport const TradeDirectionSchema = z.enum([\r\n  'Open Long',\r\n  'Open Short',\r\n  'Close Long',\r\n  'Close Short',\r\n]);\r\n\r\nexport const DataSourceSchema = z.enum(['s3', 'ws', 'api', 'live']);\r\n\r\nexport const TradeSchema = z.object({\r\n  coin: z.string(),\r\n  side: TradeSideSchema,\r\n  price: z.string(),\r\n  size: z.string(),\r\n  timestamp: z.string(),\r\n  tx_hash: z.string().optional(),\r\n  trade_id: z.number().optional(),\r\n  order_id: z.number().optional(),\r\n  crossed: z.boolean().optional(),\r\n  fee: z.string().optional(),\r\n  fee_token: z.string().optional(),\r\n  closed_pnl: z.string().optional(),\r\n  direction: TradeDirectionSchema.optional(),\r\n  start_position: z.string().optional(),\r\n  source: DataSourceSchema.optional(),\r\n  user_address: z.string().optional(),\r\n  maker_address: z.string().optional(),\r\n  taker_address: z.string().optional(),\r\n});\r\n\r\n// =============================================================================\r\n// Instrument Schemas\r\n// =============================================================================\r\n\r\nexport const InstrumentTypeSchema = z.enum(['perp', 'spot']);\r\n\r\nexport const InstrumentSchema = z.object({\r\n  name: z.string(),\r\n  szDecimals: z.number(),\r\n  maxLeverage: z.number().optional(),\r\n  onlyIsolated: z.boolean().optional(),\r\n  instrumentType: InstrumentTypeSchema.optional(),\r\n  isActive: z.boolean(),\r\n});\r\n\r\n// =============================================================================\r\n// Funding Schemas\r\n// =============================================================================\r\n\r\nexport const FundingRateSchema = z.object({\r\n  coin: z.string(),\r\n  timestamp: z.string(),\r\n  funding_rate: z.string(),\r\n  premium: z.string().optional(),\r\n});\r\n\r\n// =============================================================================\r\n// Open Interest Schemas\r\n// =============================================================================\r\n\r\nexport const OpenInterestSchema = z.object({\r\n  coin: z.string(),\r\n  timestamp: z.string(),\r\n  open_interest: z.string(),\r\n  mark_price: z.string().optional(),\r\n  oracle_price: z.string().optional(),\r\n  day_ntl_volume: z.string().optional(),\r\n  prev_day_price: z.string().optional(),\r\n  mid_price: z.string().optional(),\r\n  impact_bid_price: z.string().optional(),\r\n  impact_ask_price: z.string().optional(),\r\n});\r\n\r\n// =============================================================================\r\n// WebSocket Message Schemas\r\n// =============================================================================\r\n\r\nexport const WsChannelSchema = z.enum(['orderbook', 'trades', 'ticker', 'all_tickers']);\r\n\r\nexport const WsConnectionStateSchema = z.enum(['connecting', 'connected', 'disconnected', 'reconnecting']);\r\n\r\n// Server -> Client messages\r\nexport const WsSubscribedSchema = z.object({\r\n  type: z.literal('subscribed'),\r\n  channel: WsChannelSchema,\r\n  coin: z.string().optional(),\r\n});\r\n\r\nexport const WsUnsubscribedSchema = z.object({\r\n  type: z.literal('unsubscribed'),\r\n  channel: WsChannelSchema,\r\n  coin: z.string().optional(),\r\n});\r\n\r\nexport const WsPongSchema = z.object({\r\n  type: z.literal('pong'),\r\n});\r\n\r\nexport const WsErrorSchema = z.object({\r\n  type: z.literal('error'),\r\n  message: z.string(),\r\n});\r\n\r\nexport const WsDataSchema = z.object({\r\n  type: z.literal('data'),\r\n  channel: WsChannelSchema,\r\n  coin: z.string(),\r\n  data: z.unknown(),\r\n});\r\n\r\n// Replay messages\r\nexport const WsReplayStartedSchema = z.object({\r\n  type: z.literal('replay_started'),\r\n  channel: WsChannelSchema,\r\n  coin: z.string(),\r\n  start: z.number(),\r\n  end: z.number(),\r\n  speed: z.number(),\r\n});\r\n\r\nexport const WsReplayPausedSchema = z.object({\r\n  type: z.literal('replay_paused'),\r\n  current_timestamp: z.number(),\r\n});\r\n\r\nexport const WsReplayResumedSchema = z.object({\r\n  type: z.literal('replay_resumed'),\r\n  current_timestamp: z.number(),\r\n});\r\n\r\nexport const WsReplayCompletedSchema = z.object({\r\n  type: z.literal('replay_completed'),\r\n  channel: WsChannelSchema,\r\n  coin: z.string(),\r\n  snapshots_sent: z.number(),\r\n});\r\n\r\nexport const WsReplayStoppedSchema = z.object({\r\n  type: z.literal('replay_stopped'),\r\n});\r\n\r\nexport const WsHistoricalDataSchema = z.object({\r\n  type: z.literal('historical_data'),\r\n  channel: WsChannelSchema,\r\n  coin: z.string(),\r\n  timestamp: z.number(),\r\n  data: z.unknown(),\r\n});\r\n\r\n// Stream messages\r\nexport const WsStreamStartedSchema = z.object({\r\n  type: z.literal('stream_started'),\r\n  channel: WsChannelSchema,\r\n  coin: z.string(),\r\n  start: z.number(),\r\n  end: z.number(),\r\n});\r\n\r\nexport const WsStreamProgressSchema = z.object({\r\n  type: z.literal('stream_progress'),\r\n  snapshots_sent: z.number(),\r\n});\r\n\r\nexport const TimestampedRecordSchema = z.object({\r\n  timestamp: z.number(),\r\n  data: z.unknown(),\r\n});\r\n\r\nexport const WsHistoricalBatchSchema = z.object({\r\n  type: z.literal('historical_batch'),\r\n  channel: WsChannelSchema,\r\n  coin: z.string(),\r\n  data: z.array(TimestampedRecordSchema),\r\n});\r\n\r\nexport const WsStreamCompletedSchema = z.object({\r\n  type: z.literal('stream_completed'),\r\n  channel: WsChannelSchema,\r\n  coin: z.string(),\r\n  snapshots_sent: z.number(),\r\n});\r\n\r\nexport const WsStreamStoppedSchema = z.object({\r\n  type: z.literal('stream_stopped'),\r\n  snapshots_sent: z.number(),\r\n});\r\n\r\n// Union of all server messages\r\nexport const WsServerMessageSchema = z.discriminatedUnion('type', [\r\n  WsSubscribedSchema,\r\n  WsUnsubscribedSchema,\r\n  WsPongSchema,\r\n  WsErrorSchema,\r\n  WsDataSchema,\r\n  WsReplayStartedSchema,\r\n  WsReplayPausedSchema,\r\n  WsReplayResumedSchema,\r\n  WsReplayCompletedSchema,\r\n  WsReplayStoppedSchema,\r\n  WsHistoricalDataSchema,\r\n  WsStreamStartedSchema,\r\n  WsStreamProgressSchema,\r\n  WsHistoricalBatchSchema,\r\n  WsStreamCompletedSchema,\r\n  WsStreamStoppedSchema,\r\n]);\r\n\r\n// =============================================================================\r\n// API Response Schemas (pre-built for common endpoints)\r\n// =============================================================================\r\n\r\nexport const OrderBookResponseSchema = ApiResponseSchema(OrderBookSchema);\r\nexport const OrderBookArrayResponseSchema = ApiResponseSchema(z.array(OrderBookSchema));\r\nexport const TradeArrayResponseSchema = ApiResponseSchema(z.array(TradeSchema));\r\nexport const InstrumentResponseSchema = ApiResponseSchema(InstrumentSchema);\r\nexport const InstrumentArrayResponseSchema = ApiResponseSchema(z.array(InstrumentSchema));\r\nexport const FundingRateResponseSchema = ApiResponseSchema(FundingRateSchema);\r\nexport const FundingRateArrayResponseSchema = ApiResponseSchema(z.array(FundingRateSchema));\r\nexport const OpenInterestResponseSchema = ApiResponseSchema(OpenInterestSchema);\r\nexport const OpenInterestArrayResponseSchema = ApiResponseSchema(z.array(OpenInterestSchema));\r\n\r\n// =============================================================================\r\n// Type exports (inferred from schemas)\r\n// =============================================================================\r\n\r\nexport type ValidatedApiMeta = z.infer<typeof ApiMetaSchema>;\r\nexport type ValidatedPriceLevel = z.infer<typeof PriceLevelSchema>;\r\nexport type ValidatedOrderBook = z.infer<typeof OrderBookSchema>;\r\nexport type ValidatedTrade = z.infer<typeof TradeSchema>;\r\nexport type ValidatedInstrument = z.infer<typeof InstrumentSchema>;\r\nexport type ValidatedFundingRate = z.infer<typeof FundingRateSchema>;\r\nexport type ValidatedOpenInterest = z.infer<typeof OpenInterestSchema>;\r\nexport type ValidatedWsServerMessage = z.infer<typeof WsServerMessageSchema>;\r\n","import type { HttpClient } from '../http';\r\nimport type {\r\n  ApiResponse,\r\n  OrderBook,\r\n  GetOrderBookParams,\r\n  OrderBookHistoryParams,\r\n} from '../types';\r\nimport { OrderBookResponseSchema, OrderBookArrayResponseSchema } from '../schemas';\r\n\r\n/**\r\n * Order book API resource\r\n *\r\n * @example\r\n * ```typescript\r\n * // Get current order book\r\n * const orderbook = await client.orderbook.get('BTC');\r\n *\r\n * // Get order book at specific timestamp\r\n * const historical = await client.orderbook.get('ETH', {\r\n *   timestamp: 1704067200000,\r\n *   depth: 10\r\n * });\r\n *\r\n * // Get order book history\r\n * const history = await client.orderbook.history('BTC', {\r\n *   start: Date.now() - 86400000,\r\n *   end: Date.now(),\r\n *   limit: 100\r\n * });\r\n * ```\r\n */\r\nexport class OrderBookResource {\r\n  constructor(private http: HttpClient) {}\r\n\r\n  /**\r\n   * Get order book snapshot for a coin\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @param params - Optional parameters\r\n   * @returns Order book snapshot\r\n   */\r\n  async get(coin: string, params?: GetOrderBookParams): Promise<OrderBook> {\r\n    const response = await this.http.get<ApiResponse<OrderBook>>(\r\n      `/v1/orderbook/${coin.toUpperCase()}`,\r\n      params as Record<string, unknown>,\r\n      this.http.validationEnabled ? OrderBookResponseSchema : undefined\r\n    );\r\n    return response.data;\r\n  }\r\n\r\n  /**\r\n   * Get historical order book snapshots\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @param params - Time range and pagination parameters (start is required)\r\n   * @returns Array of order book snapshots\r\n   */\r\n  async history(\r\n    coin: string,\r\n    params: OrderBookHistoryParams\r\n  ): Promise<OrderBook[]> {\r\n    const response = await this.http.get<ApiResponse<OrderBook[]>>(\r\n      `/v1/orderbook/${coin.toUpperCase()}/history`,\r\n      params as unknown as Record<string, unknown>,\r\n      this.http.validationEnabled ? OrderBookArrayResponseSchema : undefined\r\n    );\r\n    return response.data;\r\n  }\r\n}\r\n","import type { HttpClient } from '../http';\r\nimport type { ApiResponse, Trade, GetTradesParams, GetTradesCursorParams, CursorResponse } from '../types';\r\nimport { TradeArrayResponseSchema } from '../schemas';\r\n\r\n/**\r\n * Trades API resource\r\n *\r\n * @example\r\n * ```typescript\r\n * // Get recent trades\r\n * const trades = await client.trades.recent('BTC');\r\n *\r\n * // Get trade history with cursor-based pagination (recommended)\r\n * let result = await client.trades.list('BTC', {\r\n *   start: Date.now() - 86400000,\r\n *   end: Date.now(),\r\n *   limit: 1000\r\n * });\r\n *\r\n * // Get all pages\r\n * const allTrades = [...result.data];\r\n * while (result.nextCursor) {\r\n *   result = await client.trades.list('BTC', {\r\n *     start: Date.now() - 86400000,\r\n *     end: Date.now(),\r\n *     cursor: result.nextCursor,\r\n *     limit: 1000\r\n *   });\r\n *   allTrades.push(...result.data);\r\n * }\r\n * ```\r\n */\r\nexport class TradesResource {\r\n  constructor(private http: HttpClient) {}\r\n\r\n  /**\r\n   * Get trade history for a coin using cursor-based pagination\r\n   *\r\n   * Uses cursor-based pagination by default, which is more efficient for large datasets.\r\n   * Use the `nextCursor` from the response as the `cursor` parameter to get the next page.\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @param params - Time range and cursor pagination parameters (start and end are required)\r\n   * @returns Object with trades array and nextCursor for pagination\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * // First page\r\n   * let result = await client.trades.list('BTC', {\r\n   *   start: Date.now() - 86400000,\r\n   *   end: Date.now(),\r\n   *   limit: 1000\r\n   * });\r\n   *\r\n   * // Subsequent pages\r\n   * while (result.nextCursor) {\r\n   *   result = await client.trades.list('BTC', {\r\n   *     start: Date.now() - 86400000,\r\n   *     end: Date.now(),\r\n   *     cursor: result.nextCursor,\r\n   *     limit: 1000\r\n   *   });\r\n   * }\r\n   * ```\r\n   */\r\n  async list(coin: string, params: GetTradesCursorParams): Promise<CursorResponse<Trade[]>> {\r\n    const response = await this.http.get<ApiResponse<Trade[]>>(\r\n      `/v1/trades/${coin.toUpperCase()}`,\r\n      params as unknown as Record<string, unknown>,\r\n      this.http.validationEnabled ? TradeArrayResponseSchema : undefined\r\n    );\r\n    return {\r\n      data: response.data,\r\n      nextCursor: response.meta.next_cursor,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Get most recent trades for a coin\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @param limit - Number of trades to return (default: 100)\r\n   * @returns Array of recent trades\r\n   */\r\n  async recent(coin: string, limit?: number): Promise<Trade[]> {\r\n    const response = await this.http.get<ApiResponse<Trade[]>>(\r\n      `/v1/trades/${coin.toUpperCase()}/recent`,\r\n      { limit },\r\n      this.http.validationEnabled ? TradeArrayResponseSchema : undefined\r\n    );\r\n    return response.data;\r\n  }\r\n\r\n  /**\r\n   * Get trade history using cursor-based pagination (explicit endpoint)\r\n   *\r\n   * @deprecated Use `list()` instead - it now uses cursor-based pagination by default.\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @param params - Cursor pagination parameters (start and end are required)\r\n   * @returns Object with trades array and nextCursor for pagination\r\n   */\r\n  async listWithCursor(coin: string, params: GetTradesCursorParams): Promise<CursorResponse<Trade[]>> {\r\n    // Now just calls the main endpoint since it supports cursor by default\r\n    return this.list(coin, params);\r\n  }\r\n\r\n  /**\r\n   * Get trade history using offset-based pagination\r\n   *\r\n   * @deprecated Use `list()` with cursor-based pagination instead for better performance.\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @param params - Time range and offset pagination parameters\r\n   * @returns Array of trades (without cursor response wrapper)\r\n   */\r\n  async listWithOffset(coin: string, params: GetTradesParams): Promise<Trade[]> {\r\n    const response = await this.http.get<ApiResponse<Trade[]>>(\r\n      `/v1/trades/${coin.toUpperCase()}`,\r\n      params as unknown as Record<string, unknown>,\r\n      this.http.validationEnabled ? TradeArrayResponseSchema : undefined\r\n    );\r\n    return response.data;\r\n  }\r\n}\r\n","import type { HttpClient } from '../http';\r\nimport type { ApiResponse, Instrument } from '../types';\r\nimport { InstrumentResponseSchema, InstrumentArrayResponseSchema } from '../schemas';\r\n\r\n/**\r\n * Instruments API resource\r\n *\r\n * @example\r\n * ```typescript\r\n * // List all instruments\r\n * const instruments = await client.instruments.list();\r\n *\r\n * // Get specific instrument\r\n * const btc = await client.instruments.get('BTC');\r\n * ```\r\n */\r\nexport class InstrumentsResource {\r\n  constructor(private http: HttpClient) {}\r\n\r\n  /**\r\n   * List all available trading instruments\r\n   *\r\n   * @returns Array of instruments\r\n   */\r\n  async list(): Promise<Instrument[]> {\r\n    const response = await this.http.get<ApiResponse<Instrument[]>>(\r\n      '/v1/instruments',\r\n      undefined,\r\n      this.http.validationEnabled ? InstrumentArrayResponseSchema : undefined\r\n    );\r\n    return response.data;\r\n  }\r\n\r\n  /**\r\n   * Get a specific instrument by coin symbol\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @returns Instrument details\r\n   */\r\n  async get(coin: string): Promise<Instrument> {\r\n    const response = await this.http.get<ApiResponse<Instrument>>(\r\n      `/v1/instruments/${coin.toUpperCase()}`,\r\n      undefined,\r\n      this.http.validationEnabled ? InstrumentResponseSchema : undefined\r\n    );\r\n    return response.data;\r\n  }\r\n}\r\n","import type { HttpClient } from '../http';\r\nimport type { ApiResponse, FundingRate, TimeRangeParams } from '../types';\r\nimport { FundingRateResponseSchema, FundingRateArrayResponseSchema } from '../schemas';\r\n\r\n/**\r\n * Funding rates API resource\r\n *\r\n * @example\r\n * ```typescript\r\n * // Get current funding rate\r\n * const current = await client.funding.current('BTC');\r\n *\r\n * // Get funding rate history\r\n * const history = await client.funding.history('ETH', {\r\n *   start: Date.now() - 86400000 * 7,\r\n *   end: Date.now()\r\n * });\r\n * ```\r\n */\r\nexport class FundingResource {\r\n  constructor(private http: HttpClient) {}\r\n\r\n  /**\r\n   * Get funding rate history for a coin\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @param params - Time range and pagination parameters (start is required)\r\n   * @returns Array of funding rate records\r\n   */\r\n  async history(coin: string, params: TimeRangeParams): Promise<FundingRate[]> {\r\n    const response = await this.http.get<ApiResponse<FundingRate[]>>(\r\n      `/v1/funding/${coin.toUpperCase()}`,\r\n      params as unknown as Record<string, unknown>,\r\n      this.http.validationEnabled ? FundingRateArrayResponseSchema : undefined\r\n    );\r\n    return response.data;\r\n  }\r\n\r\n  /**\r\n   * Get current funding rate for a coin\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @returns Current funding rate\r\n   */\r\n  async current(coin: string): Promise<FundingRate> {\r\n    const response = await this.http.get<ApiResponse<FundingRate>>(\r\n      `/v1/funding/${coin.toUpperCase()}/current`,\r\n      undefined,\r\n      this.http.validationEnabled ? FundingRateResponseSchema : undefined\r\n    );\r\n    return response.data;\r\n  }\r\n}\r\n","import type { HttpClient } from '../http';\r\nimport type { ApiResponse, OpenInterest, TimeRangeParams } from '../types';\r\nimport { OpenInterestResponseSchema, OpenInterestArrayResponseSchema } from '../schemas';\r\n\r\n/**\r\n * Open interest API resource\r\n *\r\n * @example\r\n * ```typescript\r\n * // Get current open interest\r\n * const current = await client.openInterest.current('BTC');\r\n *\r\n * // Get open interest history\r\n * const history = await client.openInterest.history('ETH', {\r\n *   start: Date.now() - 86400000,\r\n *   end: Date.now(),\r\n *   limit: 100\r\n * });\r\n * ```\r\n */\r\nexport class OpenInterestResource {\r\n  constructor(private http: HttpClient) {}\r\n\r\n  /**\r\n   * Get open interest history for a coin\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @param params - Time range and pagination parameters (start is required)\r\n   * @returns Array of open interest records\r\n   */\r\n  async history(coin: string, params: TimeRangeParams): Promise<OpenInterest[]> {\r\n    const response = await this.http.get<ApiResponse<OpenInterest[]>>(\r\n      `/v1/openinterest/${coin.toUpperCase()}`,\r\n      params as unknown as Record<string, unknown>,\r\n      this.http.validationEnabled ? OpenInterestArrayResponseSchema : undefined\r\n    );\r\n    return response.data;\r\n  }\r\n\r\n  /**\r\n   * Get current open interest for a coin\r\n   *\r\n   * @param coin - The coin symbol (e.g., 'BTC', 'ETH')\r\n   * @returns Current open interest\r\n   */\r\n  async current(coin: string): Promise<OpenInterest> {\r\n    const response = await this.http.get<ApiResponse<OpenInterest>>(\r\n      `/v1/openinterest/${coin.toUpperCase()}/current`,\r\n      undefined,\r\n      this.http.validationEnabled ? OpenInterestResponseSchema : undefined\r\n    );\r\n    return response.data;\r\n  }\r\n}\r\n","import type { ClientOptions } from './types';\r\nimport { HttpClient } from './http';\r\nimport {\r\n  OrderBookResource,\r\n  TradesResource,\r\n  InstrumentsResource,\r\n  FundingResource,\r\n  OpenInterestResource,\r\n} from './resources';\r\n\r\nconst DEFAULT_BASE_URL = 'https://api.0xarchive.io';\r\nconst DEFAULT_TIMEOUT = 30000;\r\n\r\n/**\r\n * 0xarchive API client\r\n *\r\n * @example\r\n * ```typescript\r\n * import { OxArchive } from '@0xarchive/sdk';\r\n *\r\n * const client = new OxArchive({ apiKey: 'ox_your_api_key' });\r\n *\r\n * // Get current order book\r\n * const orderbook = await client.orderbook.get('BTC');\r\n * console.log(`BTC mid price: ${orderbook.mid_price}`);\r\n *\r\n * // Get historical data\r\n * const history = await client.orderbook.history('ETH', {\r\n *   start: Date.now() - 86400000,\r\n *   end: Date.now(),\r\n *   limit: 100\r\n * });\r\n *\r\n * // List all instruments\r\n * const instruments = await client.instruments.list();\r\n * ```\r\n */\r\nexport class OxArchive {\r\n  private http: HttpClient;\r\n\r\n  /**\r\n   * Order book data (L2 snapshots from April 2023)\r\n   */\r\n  public readonly orderbook: OrderBookResource;\r\n\r\n  /**\r\n   * Trade/fill history\r\n   */\r\n  public readonly trades: TradesResource;\r\n\r\n  /**\r\n   * Trading instruments metadata\r\n   */\r\n  public readonly instruments: InstrumentsResource;\r\n\r\n  /**\r\n   * Funding rates\r\n   */\r\n  public readonly funding: FundingResource;\r\n\r\n  /**\r\n   * Open interest\r\n   */\r\n  public readonly openInterest: OpenInterestResource;\r\n\r\n  /**\r\n   * Create a new 0xarchive client\r\n   *\r\n   * @param options - Client configuration options\r\n   */\r\n  constructor(options: ClientOptions) {\r\n    if (!options.apiKey) {\r\n      throw new Error('API key is required. Get one at https://0xarchive.io/signup');\r\n    }\r\n\r\n    this.http = new HttpClient({\r\n      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,\r\n      apiKey: options.apiKey,\r\n      timeout: options.timeout ?? DEFAULT_TIMEOUT,\r\n      validate: options.validate ?? false,\r\n    });\r\n\r\n    // Initialize resource namespaces\r\n    this.orderbook = new OrderBookResource(this.http);\r\n    this.trades = new TradesResource(this.http);\r\n    this.instruments = new InstrumentsResource(this.http);\r\n    this.funding = new FundingResource(this.http);\r\n    this.openInterest = new OpenInterestResource(this.http);\r\n  }\r\n}\r\n","/**\r\n * WebSocket client for 0xarchive real-time streaming, replay, and bulk download\r\n *\r\n * @example Real-time streaming\r\n * ```typescript\r\n * const ws = new OxArchiveWs({ apiKey: 'ox_...' });\r\n * ws.connect({\r\n *   onMessage: (msg) => console.log(msg)\r\n * });\r\n * ws.subscribeOrderbook('BTC');\r\n * ```\r\n *\r\n * @example Historical replay (like Tardis.dev)\r\n * ```typescript\r\n * const ws = new OxArchiveWs({ apiKey: 'ox_...' });\r\n * ws.connect();\r\n * ws.onHistoricalData((coin, timestamp, data) => {\r\n *   console.log(`${new Date(timestamp)}: ${data.mid_price}`);\r\n * });\r\n * ws.replay('orderbook', 'BTC', {\r\n *   start: Date.now() - 86400000,\r\n *   speed: 10 // 10x speed\r\n * });\r\n * ```\r\n *\r\n * @example Bulk streaming (like Databento)\r\n * ```typescript\r\n * const ws = new OxArchiveWs({ apiKey: 'ox_...' });\r\n * ws.connect();\r\n * const batches: OrderBook[] = [];\r\n * ws.onBatch((coin, records) => {\r\n *   batches.push(...records.map(r => r.data));\r\n * });\r\n * ws.onStreamComplete((channel, coin, count) => {\r\n *   console.log(`Downloaded ${count} records`);\r\n * });\r\n * ws.stream('orderbook', 'ETH', {\r\n *   start: Date.now() - 3600000,\r\n *   end: Date.now(),\r\n *   batchSize: 1000\r\n * });\r\n * ```\r\n */\r\n\r\nimport type {\r\n  WsOptions,\r\n  WsChannel,\r\n  WsClientMessage,\r\n  WsServerMessage,\r\n  WsConnectionState,\r\n  WsEventHandlers,\r\n  OrderBook,\r\n  PriceLevel,\r\n  Trade,\r\n  WsHistoricalData,\r\n  WsHistoricalBatch,\r\n  WsReplayStarted,\r\n  WsReplayCompleted,\r\n  WsStreamStarted,\r\n  WsStreamCompleted,\r\n  WsStreamProgress,\r\n} from './types';\r\n\r\nconst DEFAULT_WS_URL = 'wss://api.0xarchive.io/ws';\r\nconst DEFAULT_PING_INTERVAL = 30000; // 30 seconds\r\nconst DEFAULT_RECONNECT_DELAY = 1000;\r\nconst DEFAULT_MAX_RECONNECT_ATTEMPTS = 10;\r\n\r\n// Server idle timeout is 60 seconds. The SDK sends pings every 30 seconds\r\n// to keep the connection alive. Browser WebSocket API automatically responds\r\n// to WebSocket protocol-level ping frames from the server.\r\n\r\n/**\r\n * Transform raw Hyperliquid trade format to SDK Trade type.\r\n * Raw format: { px, sz, side, time, hash, tid, users: [maker, taker] }\r\n * SDK format: { coin, side, price, size, timestamp, tx_hash, trade_id, maker_address, taker_address }\r\n */\r\nfunction transformTrade(coin: string, raw: Record<string, unknown>): Trade {\r\n  // Check if already in SDK format (from REST API or historical replay)\r\n  if ('price' in raw && 'size' in raw) {\r\n    return raw as unknown as Trade;\r\n  }\r\n\r\n  // Transform from Hyperliquid raw format\r\n  const px = raw.px as string | undefined;\r\n  const sz = raw.sz as string | undefined;\r\n  const side = raw.side as string | undefined;\r\n  const time = raw.time as number | undefined;\r\n  const hash = raw.hash as string | undefined;\r\n  const tid = raw.tid as number | undefined;\r\n\r\n  // Extract user addresses from the users array (market-level WebSocket trades)\r\n  // users[0] = maker address, users[1] = taker address\r\n  const users = raw.users as string[] | undefined;\r\n  const maker_address = users && users.length > 0 ? users[0] : undefined;\r\n  const taker_address = users && users.length > 1 ? users[1] : undefined;\r\n\r\n  // Also check for user_address field (for historical replay data)\r\n  const user_address = raw.userAddress as string | undefined ?? raw.user_address as string | undefined;\r\n\r\n  return {\r\n    coin,\r\n    side: (side === 'A' || side === 'B' ? side : 'B') as 'A' | 'B',\r\n    price: px ?? '0',\r\n    size: sz ?? '0',\r\n    timestamp: time ? new Date(time).toISOString() : new Date().toISOString(),\r\n    tx_hash: hash,\r\n    trade_id: tid,\r\n    maker_address,\r\n    taker_address,\r\n    user_address,\r\n  };\r\n}\r\n\r\n/**\r\n * Transform an array of raw Hyperliquid trades to SDK Trade types.\r\n */\r\nfunction transformTrades(coin: string, rawTrades: unknown): Trade[] {\r\n  if (!Array.isArray(rawTrades)) {\r\n    // Single trade object\r\n    return [transformTrade(coin, rawTrades as Record<string, unknown>)];\r\n  }\r\n  return rawTrades.map((raw) => transformTrade(coin, raw as Record<string, unknown>));\r\n}\r\n\r\n/**\r\n * Transform raw Hyperliquid orderbook format to SDK OrderBook type.\r\n * Raw format: { coin, levels: [[{px, sz, n}, ...], [{px, sz, n}, ...]], time }\r\n * SDK format: { coin, timestamp, bids: [{px, sz, n}], asks: [{px, sz, n}], mid_price, spread, spread_bps }\r\n */\r\nfunction transformOrderbook(coin: string, raw: Record<string, unknown>): OrderBook {\r\n  // Check if already in SDK format (from REST API or historical replay)\r\n  if ('bids' in raw && 'asks' in raw) {\r\n    return raw as unknown as OrderBook;\r\n  }\r\n\r\n  // Transform from Hyperliquid raw format\r\n  // levels is [[{px, sz, n}, ...], [{px, sz, n}, ...]] where [0]=bids, [1]=asks\r\n  const levels = raw.levels as Array<Array<{ px: string; sz: string; n: number }>> | undefined;\r\n  const time = raw.time as number | undefined;\r\n\r\n  const bids: PriceLevel[] = [];\r\n  const asks: PriceLevel[] = [];\r\n\r\n  if (levels && levels.length >= 2) {\r\n    // levels[0] = bids, levels[1] = asks\r\n    // Each level is already {px, sz, n} object\r\n    for (const level of levels[0] || []) {\r\n      bids.push({ px: level.px, sz: level.sz, n: level.n });\r\n    }\r\n    for (const level of levels[1] || []) {\r\n      asks.push({ px: level.px, sz: level.sz, n: level.n });\r\n    }\r\n  }\r\n\r\n  // Calculate mid price and spread\r\n  let mid_price: string | undefined;\r\n  let spread: string | undefined;\r\n  let spread_bps: string | undefined;\r\n\r\n  if (bids.length > 0 && asks.length > 0) {\r\n    const bestBid = parseFloat(bids[0].px);\r\n    const bestAsk = parseFloat(asks[0].px);\r\n    const mid = (bestBid + bestAsk) / 2;\r\n    mid_price = mid.toString();\r\n    spread = (bestAsk - bestBid).toString();\r\n    spread_bps = ((bestAsk - bestBid) / mid * 10000).toFixed(2);\r\n  }\r\n\r\n  return {\r\n    coin,\r\n    timestamp: time ? new Date(time).toISOString() : new Date().toISOString(),\r\n    bids,\r\n    asks,\r\n    mid_price,\r\n    spread,\r\n    spread_bps,\r\n  };\r\n}\r\n\r\n/**\r\n * WebSocket client for real-time data streaming.\r\n *\r\n * **Keep-Alive:** The server sends WebSocket ping frames every 30 seconds\r\n * and will disconnect idle connections after 60 seconds. This SDK automatically\r\n * handles keep-alive by sending application-level pings at the configured interval\r\n * (default: 30 seconds). The browser WebSocket API automatically responds to\r\n * server ping frames.\r\n */\r\nexport class OxArchiveWs {\r\n  private ws: WebSocket | null = null;\r\n  private options: Required<WsOptions>;\r\n  private handlers: WsEventHandlers = {};\r\n  private subscriptions: Set<string> = new Set();\r\n  private state: WsConnectionState = 'disconnected';\r\n  private reconnectAttempts = 0;\r\n  private pingTimer: ReturnType<typeof setInterval> | null = null;\r\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\r\n\r\n  // Typed event handlers (separate from WsEventHandlers to avoid wrapping issues)\r\n  private historicalDataHandlers: Array<(coin: string, timestamp: number, data: unknown) => void> = [];\r\n  private batchHandlers: Array<(coin: string, records: Array<{ timestamp: number; data: unknown }>) => void> = [];\r\n  private replayStartHandlers: Array<(channel: WsChannel, coin: string, start: number, end: number, speed: number) => void> = [];\r\n  private replayCompleteHandlers: Array<(channel: WsChannel, coin: string, snapshotsSent: number) => void> = [];\r\n  private streamStartHandlers: Array<(channel: WsChannel, coin: string, start: number, end: number) => void> = [];\r\n  private streamProgressHandlers: Array<(snapshotsSent: number) => void> = [];\r\n  private streamCompleteHandlers: Array<(channel: WsChannel, coin: string, snapshotsSent: number) => void> = [];\r\n  private orderbookHandlers: Array<(coin: string, data: OrderBook) => void> = [];\r\n  private tradesHandlers: Array<(coin: string, data: Trade[]) => void> = [];\r\n\r\n  constructor(options: WsOptions) {\r\n    this.options = {\r\n      apiKey: options.apiKey,\r\n      wsUrl: options.wsUrl ?? DEFAULT_WS_URL,\r\n      autoReconnect: options.autoReconnect ?? true,\r\n      reconnectDelay: options.reconnectDelay ?? DEFAULT_RECONNECT_DELAY,\r\n      maxReconnectAttempts: options.maxReconnectAttempts ?? DEFAULT_MAX_RECONNECT_ATTEMPTS,\r\n      pingInterval: options.pingInterval ?? DEFAULT_PING_INTERVAL,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Connect to the WebSocket server\r\n   */\r\n  connect(handlers?: WsEventHandlers): void {\r\n    if (handlers) {\r\n      this.handlers = handlers;\r\n    }\r\n\r\n    this.setState('connecting');\r\n\r\n    const url = `${this.options.wsUrl}?apiKey=${encodeURIComponent(this.options.apiKey)}`;\r\n    this.ws = new WebSocket(url);\r\n\r\n    this.ws.onopen = () => {\r\n      this.reconnectAttempts = 0;\r\n      this.setState('connected');\r\n      this.startPing();\r\n      this.resubscribe();\r\n      this.handlers.onOpen?.();\r\n    };\r\n\r\n    this.ws.onclose = (event) => {\r\n      this.stopPing();\r\n      this.handlers.onClose?.(event.code, event.reason);\r\n\r\n      if (this.options.autoReconnect && this.state !== 'disconnected') {\r\n        this.scheduleReconnect();\r\n      } else {\r\n        this.setState('disconnected');\r\n      }\r\n    };\r\n\r\n    this.ws.onerror = () => {\r\n      const error = new Error('WebSocket connection error');\r\n      this.handlers.onError?.(error);\r\n    };\r\n\r\n    this.ws.onmessage = (event) => {\r\n      try {\r\n        const message = JSON.parse(event.data) as WsServerMessage;\r\n        this.handleMessage(message);\r\n      } catch {\r\n        // Ignore parse errors for malformed messages\r\n      }\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Disconnect from the WebSocket server\r\n   */\r\n  disconnect(): void {\r\n    this.setState('disconnected');\r\n    this.stopPing();\r\n    this.clearReconnectTimer();\r\n\r\n    if (this.ws) {\r\n      this.ws.close(1000, 'Client disconnect');\r\n      this.ws = null;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Subscribe to a channel\r\n   */\r\n  subscribe(channel: WsChannel, coin?: string): void {\r\n    const key = this.subscriptionKey(channel, coin);\r\n    this.subscriptions.add(key);\r\n\r\n    if (this.isConnected()) {\r\n      this.send({ op: 'subscribe', channel, coin });\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Subscribe to order book updates for a coin\r\n   */\r\n  subscribeOrderbook(coin: string): void {\r\n    this.subscribe('orderbook', coin);\r\n  }\r\n\r\n  /**\r\n   * Subscribe to trades for a coin\r\n   */\r\n  subscribeTrades(coin: string): void {\r\n    this.subscribe('trades', coin);\r\n  }\r\n\r\n  /**\r\n   * Subscribe to ticker updates for a coin\r\n   */\r\n  subscribeTicker(coin: string): void {\r\n    this.subscribe('ticker', coin);\r\n  }\r\n\r\n  /**\r\n   * Subscribe to all tickers\r\n   */\r\n  subscribeAllTickers(): void {\r\n    this.subscribe('all_tickers');\r\n  }\r\n\r\n  /**\r\n   * Unsubscribe from a channel\r\n   */\r\n  unsubscribe(channel: WsChannel, coin?: string): void {\r\n    const key = this.subscriptionKey(channel, coin);\r\n    this.subscriptions.delete(key);\r\n\r\n    if (this.isConnected()) {\r\n      this.send({ op: 'unsubscribe', channel, coin });\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Unsubscribe from order book updates for a coin\r\n   */\r\n  unsubscribeOrderbook(coin: string): void {\r\n    this.unsubscribe('orderbook', coin);\r\n  }\r\n\r\n  /**\r\n   * Unsubscribe from trades for a coin\r\n   */\r\n  unsubscribeTrades(coin: string): void {\r\n    this.unsubscribe('trades', coin);\r\n  }\r\n\r\n  /**\r\n   * Unsubscribe from ticker updates for a coin\r\n   */\r\n  unsubscribeTicker(coin: string): void {\r\n    this.unsubscribe('ticker', coin);\r\n  }\r\n\r\n  /**\r\n   * Unsubscribe from all tickers\r\n   */\r\n  unsubscribeAllTickers(): void {\r\n    this.unsubscribe('all_tickers');\r\n  }\r\n\r\n  // ==========================================================================\r\n  // Historical Replay (Option B) - Like Tardis.dev\r\n  // ==========================================================================\r\n\r\n  /**\r\n   * Start historical replay with timing preserved\r\n   *\r\n   * @param channel - Data channel to replay\r\n   * @param coin - Trading pair (e.g., 'BTC', 'ETH')\r\n   * @param options - Replay options\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * ws.replay('orderbook', 'BTC', {\r\n   *   start: Date.now() - 86400000, // 24 hours ago\r\n   *   speed: 10 // 10x faster than real-time\r\n   * });\r\n   * ```\r\n   */\r\n  replay(\r\n    channel: WsChannel,\r\n    coin: string,\r\n    options: {\r\n      start: number;\r\n      end?: number;\r\n      speed?: number;\r\n    }\r\n  ): void {\r\n    this.send({\r\n      op: 'replay',\r\n      channel,\r\n      coin,\r\n      start: options.start,\r\n      end: options.end,\r\n      speed: options.speed ?? 1,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Pause the current replay\r\n   */\r\n  replayPause(): void {\r\n    this.send({ op: 'replay.pause' });\r\n  }\r\n\r\n  /**\r\n   * Resume a paused replay\r\n   */\r\n  replayResume(): void {\r\n    this.send({ op: 'replay.resume' });\r\n  }\r\n\r\n  /**\r\n   * Seek to a specific timestamp in the replay\r\n   * @param timestamp - Unix timestamp in milliseconds\r\n   */\r\n  replaySeek(timestamp: number): void {\r\n    this.send({ op: 'replay.seek', timestamp });\r\n  }\r\n\r\n  /**\r\n   * Stop the current replay\r\n   */\r\n  replayStop(): void {\r\n    this.send({ op: 'replay.stop' });\r\n  }\r\n\r\n  // ==========================================================================\r\n  // Bulk Streaming (Option D) - Like Databento\r\n  // ==========================================================================\r\n\r\n  /**\r\n   * Start bulk streaming for fast data download\r\n   *\r\n   * @param channel - Data channel to stream\r\n   * @param coin - Trading pair (e.g., 'BTC', 'ETH')\r\n   * @param options - Stream options\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * ws.stream('orderbook', 'ETH', {\r\n   *   start: Date.now() - 3600000, // 1 hour ago\r\n   *   end: Date.now(),\r\n   *   batchSize: 1000\r\n   * });\r\n   * ```\r\n   */\r\n  stream(\r\n    channel: WsChannel,\r\n    coin: string,\r\n    options: {\r\n      start: number;\r\n      end: number;\r\n      batchSize?: number;\r\n    }\r\n  ): void {\r\n    this.send({\r\n      op: 'stream',\r\n      channel,\r\n      coin,\r\n      start: options.start,\r\n      end: options.end,\r\n      batch_size: options.batchSize ?? 1000,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Stop the current bulk stream\r\n   */\r\n  streamStop(): void {\r\n    this.send({ op: 'stream.stop' });\r\n  }\r\n\r\n  // ==========================================================================\r\n  // Event Handlers for Replay/Stream\r\n  // ==========================================================================\r\n\r\n  /**\r\n   * Handle historical data points (replay mode)\r\n   */\r\n  onHistoricalData<T = unknown>(\r\n    handler: (coin: string, timestamp: number, data: T) => void\r\n  ): void {\r\n    this.historicalDataHandlers.push(handler as (coin: string, timestamp: number, data: unknown) => void);\r\n  }\r\n\r\n  /**\r\n   * Handle batched data (bulk stream mode)\r\n   */\r\n  onBatch<T = unknown>(\r\n    handler: (coin: string, records: Array<{ timestamp: number; data: T }>) => void\r\n  ): void {\r\n    this.batchHandlers.push(handler as (coin: string, records: Array<{ timestamp: number; data: unknown }>) => void);\r\n  }\r\n\r\n  /**\r\n   * Handle replay started event\r\n   */\r\n  onReplayStart(\r\n    handler: (channel: WsChannel, coin: string, start: number, end: number, speed: number) => void\r\n  ): void {\r\n    this.replayStartHandlers.push(handler);\r\n  }\r\n\r\n  /**\r\n   * Handle replay completed event\r\n   */\r\n  onReplayComplete(\r\n    handler: (channel: WsChannel, coin: string, snapshotsSent: number) => void\r\n  ): void {\r\n    this.replayCompleteHandlers.push(handler);\r\n  }\r\n\r\n  /**\r\n   * Handle stream started event\r\n   */\r\n  onStreamStart(\r\n    handler: (channel: WsChannel, coin: string, start: number, end: number) => void\r\n  ): void {\r\n    this.streamStartHandlers.push(handler);\r\n  }\r\n\r\n  /**\r\n   * Handle stream progress event\r\n   */\r\n  onStreamProgress(\r\n    handler: (snapshotsSent: number) => void\r\n  ): void {\r\n    this.streamProgressHandlers.push(handler);\r\n  }\r\n\r\n  /**\r\n   * Handle stream completed event\r\n   */\r\n  onStreamComplete(\r\n    handler: (channel: WsChannel, coin: string, snapshotsSent: number) => void\r\n  ): void {\r\n    this.streamCompleteHandlers.push(handler);\r\n  }\r\n\r\n  /**\r\n   * Get current connection state\r\n   */\r\n  getState(): WsConnectionState {\r\n    return this.state;\r\n  }\r\n\r\n  /**\r\n   * Check if connected\r\n   */\r\n  isConnected(): boolean {\r\n    return this.ws?.readyState === WebSocket.OPEN;\r\n  }\r\n\r\n  /**\r\n   * Set event handlers after construction\r\n   */\r\n  on<K extends keyof WsEventHandlers>(event: K, handler: WsEventHandlers[K]): void {\r\n    this.handlers[event] = handler;\r\n  }\r\n\r\n  /**\r\n   * Helper to handle typed orderbook data\r\n   */\r\n  onOrderbook(handler: (coin: string, data: OrderBook) => void): void {\r\n    this.orderbookHandlers.push(handler);\r\n  }\r\n\r\n  /**\r\n   * Helper to handle typed trade data\r\n   */\r\n  onTrades(handler: (coin: string, data: Trade[]) => void): void {\r\n    this.tradesHandlers.push(handler);\r\n  }\r\n\r\n  // Private methods\r\n\r\n  private send(message: WsClientMessage): void {\r\n    if (this.ws?.readyState === WebSocket.OPEN) {\r\n      this.ws.send(JSON.stringify(message));\r\n    }\r\n  }\r\n\r\n  private setState(state: WsConnectionState): void {\r\n    this.state = state;\r\n    this.handlers.onStateChange?.(state);\r\n  }\r\n\r\n  private startPing(): void {\r\n    this.stopPing();\r\n    this.pingTimer = setInterval(() => {\r\n      this.send({ op: 'ping' });\r\n    }, this.options.pingInterval);\r\n  }\r\n\r\n  private stopPing(): void {\r\n    if (this.pingTimer) {\r\n      clearInterval(this.pingTimer);\r\n      this.pingTimer = null;\r\n    }\r\n  }\r\n\r\n  private subscriptionKey(channel: WsChannel, coin?: string): string {\r\n    return coin ? `${channel}:${coin}` : channel;\r\n  }\r\n\r\n  private resubscribe(): void {\r\n    for (const key of this.subscriptions) {\r\n      const [channel, coin] = key.split(':') as [WsChannel, string | undefined];\r\n      this.send({ op: 'subscribe', channel, coin });\r\n    }\r\n  }\r\n\r\n  private scheduleReconnect(): void {\r\n    if (this.reconnectAttempts >= this.options.maxReconnectAttempts) {\r\n      this.setState('disconnected');\r\n      return;\r\n    }\r\n\r\n    this.setState('reconnecting');\r\n    this.reconnectAttempts++;\r\n\r\n    const delay = this.options.reconnectDelay * Math.pow(2, this.reconnectAttempts - 1);\r\n\r\n    this.reconnectTimer = setTimeout(() => {\r\n      this.connect();\r\n    }, delay);\r\n  }\r\n\r\n  private clearReconnectTimer(): void {\r\n    if (this.reconnectTimer) {\r\n      clearTimeout(this.reconnectTimer);\r\n      this.reconnectTimer = null;\r\n    }\r\n  }\r\n\r\n  private handleMessage(message: WsServerMessage): void {\r\n    // Call the generic onMessage handler first\r\n    this.handlers.onMessage?.(message);\r\n\r\n    // Dispatch to typed handlers based on message type\r\n    switch (message.type) {\r\n      case 'historical_data': {\r\n        const msg = message as WsHistoricalData;\r\n        for (const handler of this.historicalDataHandlers) {\r\n          handler(msg.coin, msg.timestamp, msg.data);\r\n        }\r\n        break;\r\n      }\r\n      case 'historical_batch': {\r\n        const msg = message as WsHistoricalBatch;\r\n        for (const handler of this.batchHandlers) {\r\n          handler(msg.coin, msg.data as Array<{ timestamp: number; data: unknown }>);\r\n        }\r\n        break;\r\n      }\r\n      case 'replay_started': {\r\n        const msg = message as WsReplayStarted;\r\n        for (const handler of this.replayStartHandlers) {\r\n          handler(msg.channel, msg.coin, msg.start, msg.end, msg.speed);\r\n        }\r\n        break;\r\n      }\r\n      case 'replay_completed': {\r\n        const msg = message as WsReplayCompleted;\r\n        for (const handler of this.replayCompleteHandlers) {\r\n          handler(msg.channel, msg.coin, msg.snapshots_sent);\r\n        }\r\n        break;\r\n      }\r\n      case 'stream_started': {\r\n        const msg = message as WsStreamStarted;\r\n        for (const handler of this.streamStartHandlers) {\r\n          handler(msg.channel, msg.coin, msg.start, msg.end);\r\n        }\r\n        break;\r\n      }\r\n      case 'stream_progress': {\r\n        const msg = message as WsStreamProgress;\r\n        for (const handler of this.streamProgressHandlers) {\r\n          handler(msg.snapshots_sent);\r\n        }\r\n        break;\r\n      }\r\n      case 'stream_completed': {\r\n        const msg = message as WsStreamCompleted;\r\n        for (const handler of this.streamCompleteHandlers) {\r\n          handler(msg.channel, msg.coin, msg.snapshots_sent);\r\n        }\r\n        break;\r\n      }\r\n      case 'data': {\r\n        if (message.channel === 'orderbook') {\r\n          // Transform raw Hyperliquid format to SDK OrderBook type\r\n          const orderbook = transformOrderbook(message.coin, message.data as Record<string, unknown>);\r\n          for (const handler of this.orderbookHandlers) {\r\n            handler(message.coin, orderbook);\r\n          }\r\n        } else if (message.channel === 'trades') {\r\n          // Transform raw Hyperliquid format to SDK Trade type\r\n          const trades = transformTrades(message.coin, message.data);\r\n          for (const handler of this.tradesHandlers) {\r\n            handler(message.coin, trades);\r\n          }\r\n        }\r\n        break;\r\n      }\r\n    }\r\n  }\r\n}\r\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xarchive/sdk",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Official TypeScript SDK for 0xarchive - Hyperliquid Historical Data API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -47,7 +47,8 @@
     "node": ">=18"
   },
   "dependencies": {
-    "ws": "^8.18.0"
+    "ws": "^8.18.0",
+    "zod": "^3.23.0"
   },
   "devDependencies": {
     "@types/ws": "^8.5.13",