@lightconexyz/lightcone-sdk 0.1.0

package/dist/websocket/types.d.ts

@@ -0,0 +1,417 @@
+/**
+ * Message types for the Lightcone WebSocket protocol.
+ *
+ * This module contains all request and response types for the WebSocket API.
+ */
+import type { WebSocketError } from "./error";
+/**
+ * Subscribe/Unsubscribe request wrapper.
+ */
+export interface WsRequest {
+    method: string;
+    params?: SubscribeParams;
+}
+/**
+ * Subscription parameters (polymorphic).
+ */
+export type SubscribeParams = BookUpdateParams | TradesParams | UserParams | PriceHistoryParams | MarketParams;
+/**
+ * Book update subscription params.
+ */
+export interface BookUpdateParams {
+    type: "book_update";
+    orderbook_ids: string[];
+}
+/**
+ * Trades subscription params.
+ */
+export interface TradesParams {
+    type: "trades";
+    orderbook_ids: string[];
+}
+/**
+ * User subscription params.
+ */
+export interface UserParams {
+    type: "user";
+    user: string;
+}
+/**
+ * Price history subscription params.
+ */
+export interface PriceHistoryParams {
+    type: "price_history";
+    orderbook_id: string;
+    resolution: string;
+    include_ohlcv: boolean;
+}
+/**
+ * Market subscription params.
+ */
+export interface MarketParams {
+    type: "market";
+    market_pubkey: string;
+}
+/**
+ * Create a subscribe request.
+ */
+export declare function createSubscribeRequest(params: SubscribeParams): WsRequest;
+/**
+ * Create an unsubscribe request.
+ */
+export declare function createUnsubscribeRequest(params: SubscribeParams): WsRequest;
+/**
+ * Create a ping request.
+ */
+export declare function createPingRequest(): WsRequest;
+/**
+ * Create book update subscription params.
+ */
+export declare function bookUpdateParams(orderbookIds: string[]): BookUpdateParams;
+/**
+ * Create trades subscription params.
+ */
+export declare function tradesParams(orderbookIds: string[]): TradesParams;
+/**
+ * Create user subscription params.
+ */
+export declare function userParams(user: string): UserParams;
+/**
+ * Create price history subscription params.
+ */
+export declare function priceHistoryParams(orderbookId: string, resolution: string, includeOhlcv: boolean): PriceHistoryParams;
+/**
+ * Create market subscription params.
+ */
+export declare function marketParams(marketPubkey: string): MarketParams;
+/**
+ * Auth response data.
+ */
+export interface AuthData {
+    status: "authenticated" | "anonymous" | "error";
+    user_pubkey?: string;
+    message?: string;
+}
+/**
+ * Server → Client message (discriminated union).
+ * TypeScript automatically narrows the `data` type based on `type` field.
+ */
+export type WsServerMessage = {
+    type: "book_update";
+    version: number;
+    data: BookUpdateData;
+} | {
+    type: "trades";
+    version: number;
+    data: TradeData;
+} | {
+    type: "user";
+    version: number;
+    data: UserEventData;
+} | {
+    type: "price_history";
+    version: number;
+    data: PriceHistoryData;
+} | {
+    type: "market";
+    version: number;
+    data: MarketEventData;
+} | {
+    type: "auth";
+    version: number;
+    data: AuthData;
+} | {
+    type: "pong";
+    version: number;
+    data: PongData;
+} | {
+    type: "error";
+    version: number;
+    data: ErrorData;
+};
+/**
+ * Parse a WebSocket message from raw text.
+ * Single validation point at JSON.parse boundary.
+ */
+export declare function parseWsMessage(text: string): WsServerMessage | null;
+/**
+ * Generic WebSocket message wrapper.
+ */
+export interface WsMessage<T> {
+    type: string;
+    version: number;
+    data: T;
+}
+/**
+ * Orderbook snapshot/delta data.
+ */
+export interface BookUpdateData {
+    orderbook_id: string;
+    timestamp: string;
+    seq: number;
+    bids: PriceLevel[];
+    asks: PriceLevel[];
+    is_snapshot: boolean;
+    resync: boolean;
+    message?: string;
+}
+/**
+ * Price level in the orderbook.
+ */
+export interface PriceLevel {
+    side: string;
+    /** Price as decimal string (e.g., "0.500000") */
+    price: string;
+    /** Size as decimal string */
+    size: string;
+}
+/**
+ * Trade execution data.
+ */
+export interface TradeData {
+    orderbook_id: string;
+    /** Price as decimal string */
+    price: string;
+    /** Size as decimal string */
+    size: string;
+    side: string;
+    timestamp: string;
+    trade_id: string;
+}
+/**
+ * User event data (snapshot, order_update, balance_update).
+ */
+export interface UserEventData {
+    event_type: string;
+    orders: Order[];
+    balances: Record<string, BalanceEntry>;
+    order?: OrderUpdate;
+    balance?: Balance;
+    market_pubkey?: string;
+    orderbook_id?: string;
+    deposit_mint?: string;
+    timestamp?: string;
+}
+/**
+ * User order from snapshot.
+ */
+export interface Order {
+    order_hash: string;
+    market_pubkey: string;
+    orderbook_id: string;
+    /** 0 = BUY, 1 = SELL */
+    side: number;
+    /** Maker amount as decimal string */
+    maker_amount: string;
+    /** Taker amount as decimal string */
+    taker_amount: string;
+    /** Remaining amount as decimal string */
+    remaining: string;
+    /** Filled amount as decimal string */
+    filled: string;
+    /** Price as decimal string */
+    price: string;
+    created_at: number;
+    expiration: number;
+}
+/**
+ * Order update from real-time event.
+ */
+export interface OrderUpdate {
+    order_hash: string;
+    /** Price as decimal string */
+    price: string;
+    /** Fill amount as decimal string */
+    fill_amount: string;
+    /** Remaining amount as decimal string */
+    remaining: string;
+    /** Filled amount as decimal string */
+    filled: string;
+    /** 0 = BUY, 1 = SELL */
+    side: number;
+    is_maker: boolean;
+    created_at: number;
+    balance?: Balance;
+}
+/**
+ * Balance containing outcome balances.
+ */
+export interface Balance {
+    outcomes: OutcomeBalance[];
+}
+/**
+ * Individual outcome balance.
+ */
+export interface OutcomeBalance {
+    outcome_index: number;
+    mint: string;
+    /** Idle balance as decimal string */
+    idle: string;
+    /** On-book balance as decimal string */
+    on_book: string;
+}
+/**
+ * Balance entry from user snapshot.
+ */
+export interface BalanceEntry {
+    market_pubkey: string;
+    deposit_mint: string;
+    outcomes: OutcomeBalance[];
+}
+/**
+ * Price history data (snapshot, update, heartbeat).
+ */
+export interface PriceHistoryData {
+    event_type: string;
+    orderbook_id?: string;
+    resolution?: string;
+    include_ohlcv?: boolean;
+    prices: Candle[];
+    last_timestamp?: number;
+    server_time?: number;
+    last_processed?: number;
+    t?: number;
+    o?: string;
+    h?: string;
+    l?: string;
+    c?: string;
+    v?: string;
+    m?: string;
+    bb?: string;
+    ba?: string;
+}
+/**
+ * Convert inline candle data to a Candle struct (for update events).
+ */
+export declare function toCandle(data: PriceHistoryData): Candle | undefined;
+/**
+ * OHLCV candle data.
+ */
+export interface Candle {
+    /** Timestamp (Unix ms) */
+    t: number;
+    /** Open price as decimal string (null if no trades) */
+    o?: string;
+    /** High price as decimal string (null if no trades) */
+    h?: string;
+    /** Low price as decimal string (null if no trades) */
+    l?: string;
+    /** Close price as decimal string (null if no trades) */
+    c?: string;
+    /** Volume as decimal string (null if no trades) */
+    v?: string;
+    /** Midpoint: (best_bid + best_ask) / 2 as decimal string */
+    m?: string;
+    /** Best bid price as decimal string */
+    bb?: string;
+    /** Best ask price as decimal string */
+    ba?: string;
+}
+/**
+ * Market event data.
+ */
+export interface MarketEventData {
+    /** Event type: "orderbook_created", "settled", "opened", "paused" */
+    event_type: string;
+    market_pubkey: string;
+    orderbook_id?: string;
+    timestamp: string;
+}
+/**
+ * Market event types.
+ */
+export type MarketEventType = "OrderbookCreated" | "Settled" | "Opened" | "Paused" | "Unknown";
+/**
+ * Parse market event type from string.
+ */
+export declare function parseMarketEventType(s: string): MarketEventType;
+/**
+ * Error response from server.
+ */
+export interface ErrorData {
+    error: string;
+    code: string;
+    orderbook_id?: string;
+}
+/**
+ * Server error codes.
+ */
+export type ErrorCode = "EngineUnavailable" | "InvalidJson" | "InvalidMethod" | "RateLimited" | "Unknown";
+/**
+ * Parse error code from string.
+ */
+export declare function parseErrorCode(s: string): ErrorCode;
+/**
+ * Pong response data (empty).
+ */
+export interface PongData {
+}
+/**
+ * Events emitted by the WebSocket client.
+ */
+export type WsEvent = {
+    type: "Connected";
+} | {
+    type: "Disconnected";
+    reason: string;
+} | {
+    type: "BookUpdate";
+    orderbookId: string;
+    isSnapshot: boolean;
+} | {
+    type: "Trade";
+    orderbookId: string;
+    trade: TradeData;
+} | {
+    type: "UserUpdate";
+    eventType: string;
+    user: string;
+} | {
+    type: "PriceUpdate";
+    orderbookId: string;
+    resolution: string;
+} | {
+    type: "MarketEvent";
+    eventType: string;
+    marketPubkey: string;
+} | {
+    type: "Error";
+    error: WebSocketError;
+} | {
+    type: "ResyncRequired";
+    orderbookId: string;
+} | {
+    type: "Pong";
+} | {
+    type: "Reconnecting";
+    attempt: number;
+};
+/**
+ * Enum for all possible server message types.
+ */
+export type MessageType = "BookUpdate" | "Trades" | "User" | "PriceHistory" | "Market" | "Error" | "Pong" | "Unknown";
+/**
+ * Parse message type from string.
+ */
+export declare function parseMessageType(s: string): MessageType;
+/**
+ * Order side enum for user events.
+ */
+export type Side = "Buy" | "Sell";
+/**
+ * Parse side from number.
+ */
+export declare function parseSide(value: number): Side;
+/**
+ * Convert side to number.
+ */
+export declare function sideToNumber(side: Side): number;
+/**
+ * Price level side (from orderbook updates).
+ */
+export type PriceLevelSide = "Bid" | "Ask";
+/**
+ * Parse price level side from string.
+ */
+export declare function parsePriceLevelSide(s: string): PriceLevelSide;
+//# sourceMappingURL=types.d.ts.map

package/dist/websocket/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/websocket/types.ts"],"names":[],"mappings":"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"}

package/dist/websocket/types.js

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * Message types for the Lightcone WebSocket protocol.
+ *
+ * This module contains all request and response types for the WebSocket API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSubscribeRequest = createSubscribeRequest;
+exports.createUnsubscribeRequest = createUnsubscribeRequest;
+exports.createPingRequest = createPingRequest;
+exports.bookUpdateParams = bookUpdateParams;
+exports.tradesParams = tradesParams;
+exports.userParams = userParams;
+exports.priceHistoryParams = priceHistoryParams;
+exports.marketParams = marketParams;
+exports.parseWsMessage = parseWsMessage;
+exports.toCandle = toCandle;
+exports.parseMarketEventType = parseMarketEventType;
+exports.parseErrorCode = parseErrorCode;
+exports.parseMessageType = parseMessageType;
+exports.parseSide = parseSide;
+exports.sideToNumber = sideToNumber;
+exports.parsePriceLevelSide = parsePriceLevelSide;
+/**
+ * Create a subscribe request.
+ */
+function createSubscribeRequest(params) {
+    return { method: "subscribe", params };
+}
+/**
+ * Create an unsubscribe request.
+ */
+function createUnsubscribeRequest(params) {
+    return { method: "unsubscribe", params };
+}
+/**
+ * Create a ping request.
+ */
+function createPingRequest() {
+    return { method: "ping" };
+}
+/**
+ * Create book update subscription params.
+ */
+function bookUpdateParams(orderbookIds) {
+    return { type: "book_update", orderbook_ids: orderbookIds };
+}
+/**
+ * Create trades subscription params.
+ */
+function tradesParams(orderbookIds) {
+    return { type: "trades", orderbook_ids: orderbookIds };
+}
+/**
+ * Create user subscription params.
+ */
+function userParams(user) {
+    return { type: "user", user };
+}
+/**
+ * Create price history subscription params.
+ */
+function priceHistoryParams(orderbookId, resolution, includeOhlcv) {
+    return {
+        type: "price_history",
+        orderbook_id: orderbookId,
+        resolution,
+        include_ohlcv: includeOhlcv,
+    };
+}
+/**
+ * Create market subscription params.
+ */
+function marketParams(marketPubkey) {
+    return { type: "market", market_pubkey: marketPubkey };
+}
+/**
+ * Parse a WebSocket message from raw text.
+ * Single validation point at JSON.parse boundary.
+ */
+function parseWsMessage(text) {
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    if (typeof raw !== "object" || raw === null)
+        return null;
+    const obj = raw;
+    if (typeof obj.type !== "string" || typeof obj.version !== "number") {
+        return null;
+    }
+    // All message types except "pong" must have a data field
+    if (obj.type !== "pong" && (obj.data === undefined || obj.data === null)) {
+        return null;
+    }
+    // We trust the server sends correct data shapes for each type
+    return obj;
+}
+/**
+ * Convert inline candle data to a Candle struct (for update events).
+ */
+function toCandle(data) {
+    if (data.t === undefined)
+        return undefined;
+    return {
+        t: data.t,
+        o: data.o,
+        h: data.h,
+        l: data.l,
+        c: data.c,
+        v: data.v,
+        m: data.m,
+        bb: data.bb,
+        ba: data.ba,
+    };
+}
+/**
+ * Parse market event type from string.
+ */
+function parseMarketEventType(s) {
+    switch (s) {
+        case "orderbook_created":
+            return "OrderbookCreated";
+        case "settled":
+            return "Settled";
+        case "opened":
+            return "Opened";
+        case "paused":
+            return "Paused";
+        default:
+            return "Unknown";
+    }
+}
+/**
+ * Parse error code from string.
+ */
+function parseErrorCode(s) {
+    switch (s) {
+        case "ENGINE_UNAVAILABLE":
+            return "EngineUnavailable";
+        case "INVALID_JSON":
+            return "InvalidJson";
+        case "INVALID_METHOD":
+            return "InvalidMethod";
+        case "RATE_LIMITED":
+            return "RateLimited";
+        default:
+            return "Unknown";
+    }
+}
+/**
+ * Parse message type from string.
+ */
+function parseMessageType(s) {
+    switch (s) {
+        case "book_update":
+            return "BookUpdate";
+        case "trades":
+            return "Trades";
+        case "user":
+            return "User";
+        case "price_history":
+            return "PriceHistory";
+        case "market":
+            return "Market";
+        case "error":
+            return "Error";
+        case "pong":
+            return "Pong";
+        default:
+            return "Unknown";
+    }
+}
+/**
+ * Parse side from number.
+ */
+function parseSide(value) {
+    return value === 0 ? "Buy" : "Sell";
+}
+/**
+ * Convert side to number.
+ */
+function sideToNumber(side) {
+    return side === "Buy" ? 0 : 1;
+}
+/**
+ * Parse price level side from string.
+ */
+function parsePriceLevelSide(s) {
+    return s === "bid" ? "Bid" : "Ask";
+}
+//# sourceMappingURL=types.js.map

package/dist/websocket/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/websocket/types.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Message types for the Lightcone WebSocket protocol.\n *\n * This module contains all request and response types for the WebSocket API.\n */\n\nimport type { WebSocketError } from \"./error\";\n\n// ============================================================================\n// REQUEST TYPES (Client → Server)\n// ============================================================================\n\n/**\n * Subscribe/Unsubscribe request wrapper.\n */\nexport interface WsRequest {\n  method: string;\n  params?: SubscribeParams;\n}\n\n/**\n * Subscription parameters (polymorphic).\n */\nexport type SubscribeParams =\n  | BookUpdateParams\n  | TradesParams\n  | UserParams\n  | PriceHistoryParams\n  | MarketParams;\n\n/**\n * Book update subscription params.\n */\nexport interface BookUpdateParams {\n  type: \"book_update\";\n  orderbook_ids: string[];\n}\n\n/**\n * Trades subscription params.\n */\nexport interface TradesParams {\n  type: \"trades\";\n  orderbook_ids: string[];\n}\n\n/**\n * User subscription params.\n */\nexport interface UserParams {\n  type: \"user\";\n  user: string;\n}\n\n/**\n * Price history subscription params.\n */\nexport interface PriceHistoryParams {\n  type: \"price_history\";\n  orderbook_id: string;\n  resolution: string;\n  include_ohlcv: boolean;\n}\n\n/**\n * Market subscription params.\n */\nexport interface MarketParams {\n  type: \"market\";\n  market_pubkey: string;\n}\n\n/**\n * Create a subscribe request.\n */\nexport function createSubscribeRequest(params: SubscribeParams): WsRequest {\n  return { method: \"subscribe\", params };\n}\n\n/**\n * Create an unsubscribe request.\n */\nexport function createUnsubscribeRequest(params: SubscribeParams): WsRequest {\n  return { method: \"unsubscribe\", params };\n}\n\n/**\n * Create a ping request.\n */\nexport function createPingRequest(): WsRequest {\n  return { method: \"ping\" };\n}\n\n/**\n * Create book update subscription params.\n */\nexport function bookUpdateParams(orderbookIds: string[]): BookUpdateParams {\n  return { type: \"book_update\", orderbook_ids: orderbookIds };\n}\n\n/**\n * Create trades subscription params.\n */\nexport function tradesParams(orderbookIds: string[]): TradesParams {\n  return { type: \"trades\", orderbook_ids: orderbookIds };\n}\n\n/**\n * Create user subscription params.\n */\nexport function userParams(user: string): UserParams {\n  return { type: \"user\", user };\n}\n\n/**\n * Create price history subscription params.\n */\nexport function priceHistoryParams(\n  orderbookId: string,\n  resolution: string,\n  includeOhlcv: boolean\n): PriceHistoryParams {\n  return {\n    type: \"price_history\",\n    orderbook_id: orderbookId,\n    resolution,\n    include_ohlcv: includeOhlcv,\n  };\n}\n\n/**\n * Create market subscription params.\n */\nexport function marketParams(marketPubkey: string): MarketParams {\n  return { type: \"market\", market_pubkey: marketPubkey };\n}\n\n// ============================================================================\n// RESPONSE TYPES (Server → Client)\n// ============================================================================\n\n/**\n * Auth response data.\n */\nexport interface AuthData {\n  status: \"authenticated\" | \"anonymous\" | \"error\";\n  user_pubkey?: string;\n  message?: string;\n}\n\n/**\n * Server → Client message (discriminated union).\n * TypeScript automatically narrows the `data` type based on `type` field.\n */\nexport type WsServerMessage =\n  | { type: \"book_update\"; version: number; data: BookUpdateData }\n  | { type: \"trades\"; version: number; data: TradeData }\n  | { type: \"user\"; version: number; data: UserEventData }\n  | { type: \"price_history\"; version: number; data: PriceHistoryData }\n  | { type: \"market\"; version: number; data: MarketEventData }\n  | { type: \"auth\"; version: number; data: AuthData }\n  | { type: \"pong\"; version: number; data: PongData }\n  | { type: \"error\"; version: number; data: ErrorData };\n\n/**\n * Parse a WebSocket message from raw text.\n * Single validation point at JSON.parse boundary.\n */\nexport function parseWsMessage(text: string): WsServerMessage | null {\n  let raw: unknown;\n  try {\n    raw = JSON.parse(text);\n  } catch {\n    return null;\n  }\n\n  if (typeof raw !== \"object\" || raw === null) return null;\n  const obj = raw as Record<string, unknown>;\n\n  if (typeof obj.type !== \"string\" || typeof obj.version !== \"number\") {\n    return null;\n  }\n\n  // All message types except \"pong\" must have a data field\n  if (obj.type !== \"pong\" && (obj.data === undefined || obj.data === null)) {\n    return null;\n  }\n\n  // We trust the server sends correct data shapes for each type\n  return obj as WsServerMessage;\n}\n\n/**\n * Generic WebSocket message wrapper.\n */\nexport interface WsMessage<T> {\n  type: string;\n  version: number;\n  data: T;\n}\n\n// ============================================================================\n// BOOK UPDATE TYPES\n// ============================================================================\n\n/**\n * Orderbook snapshot/delta data.\n */\nexport interface BookUpdateData {\n  orderbook_id: string;\n  timestamp: string;\n  seq: number;\n  bids: PriceLevel[];\n  asks: PriceLevel[];\n  is_snapshot: boolean;\n  resync: boolean;\n  message?: string;\n}\n\n/**\n * Price level in the orderbook.\n */\nexport interface PriceLevel {\n  side: string;\n  /** Price as decimal string (e.g., \"0.500000\") */\n  price: string;\n  /** Size as decimal string */\n  size: string;\n}\n\n// ============================================================================\n// TRADE TYPES\n// ============================================================================\n\n/**\n * Trade execution data.\n */\nexport interface TradeData {\n  orderbook_id: string;\n  /** Price as decimal string */\n  price: string;\n  /** Size as decimal string */\n  size: string;\n  side: string;\n  timestamp: string;\n  trade_id: string;\n}\n\n// ============================================================================\n// USER EVENT TYPES\n// ============================================================================\n\n/**\n * User event data (snapshot, order_update, balance_update).\n */\nexport interface UserEventData {\n  event_type: string;\n  orders: Order[];\n  balances: Record<string, BalanceEntry>;\n  order?: OrderUpdate;\n  balance?: Balance;\n  market_pubkey?: string;\n  orderbook_id?: string;\n  deposit_mint?: string;\n  timestamp?: string;\n}\n\n/**\n * User order from snapshot.\n */\nexport interface Order {\n  order_hash: string;\n  market_pubkey: string;\n  orderbook_id: string;\n  /** 0 = BUY, 1 = SELL */\n  side: number;\n  /** Maker amount as decimal string */\n  maker_amount: string;\n  /** Taker amount as decimal string */\n  taker_amount: string;\n  /** Remaining amount as decimal string */\n  remaining: string;\n  /** Filled amount as decimal string */\n  filled: string;\n  /** Price as decimal string */\n  price: string;\n  created_at: number;\n  expiration: number;\n}\n\n/**\n * Order update from real-time event.\n */\nexport interface OrderUpdate {\n  order_hash: string;\n  /** Price as decimal string */\n  price: string;\n  /** Fill amount as decimal string */\n  fill_amount: string;\n  /** Remaining amount as decimal string */\n  remaining: string;\n  /** Filled amount as decimal string */\n  filled: string;\n  /** 0 = BUY, 1 = SELL */\n  side: number;\n  is_maker: boolean;\n  created_at: number;\n  balance?: Balance;\n}\n\n/**\n * Balance containing outcome balances.\n */\nexport interface Balance {\n  outcomes: OutcomeBalance[];\n}\n\n/**\n * Individual outcome balance.\n */\nexport interface OutcomeBalance {\n  outcome_index: number;\n  mint: string;\n  /** Idle balance as decimal string */\n  idle: string;\n  /** On-book balance as decimal string */\n  on_book: string;\n}\n\n/**\n * Balance entry from user snapshot.\n */\nexport interface BalanceEntry {\n  market_pubkey: string;\n  deposit_mint: string;\n  outcomes: OutcomeBalance[];\n}\n\n// ============================================================================\n// PRICE HISTORY TYPES\n// ============================================================================\n\n/**\n * Price history data (snapshot, update, heartbeat).\n */\nexport interface PriceHistoryData {\n  event_type: string;\n  orderbook_id?: string;\n  resolution?: string;\n  include_ohlcv?: boolean;\n  prices: Candle[];\n  last_timestamp?: number;\n  server_time?: number;\n  last_processed?: number;\n  // For updates (inline candle data)\n  t?: number;\n  o?: string;\n  h?: string;\n  l?: string;\n  c?: string;\n  v?: string;\n  m?: string;\n  bb?: string;\n  ba?: string;\n}\n\n/**\n * Convert inline candle data to a Candle struct (for update events).\n */\nexport function toCandle(data: PriceHistoryData): Candle | undefined {\n  if (data.t === undefined) return undefined;\n  return {\n    t: data.t,\n    o: data.o,\n    h: data.h,\n    l: data.l,\n    c: data.c,\n    v: data.v,\n    m: data.m,\n    bb: data.bb,\n    ba: data.ba,\n  };\n}\n\n/**\n * OHLCV candle data.\n */\nexport interface Candle {\n  /** Timestamp (Unix ms) */\n  t: number;\n  /** Open price as decimal string (null if no trades) */\n  o?: string;\n  /** High price as decimal string (null if no trades) */\n  h?: string;\n  /** Low price as decimal string (null if no trades) */\n  l?: string;\n  /** Close price as decimal string (null if no trades) */\n  c?: string;\n  /** Volume as decimal string (null if no trades) */\n  v?: string;\n  /** Midpoint: (best_bid + best_ask) / 2 as decimal string */\n  m?: string;\n  /** Best bid price as decimal string */\n  bb?: string;\n  /** Best ask price as decimal string */\n  ba?: string;\n}\n\n// ============================================================================\n// MARKET EVENT TYPES\n// ============================================================================\n\n/**\n * Market event data.\n */\nexport interface MarketEventData {\n  /** Event type: \"orderbook_created\", \"settled\", \"opened\", \"paused\" */\n  event_type: string;\n  market_pubkey: string;\n  orderbook_id?: string;\n  timestamp: string;\n}\n\n/**\n * Market event types.\n */\nexport type MarketEventType =\n  | \"OrderbookCreated\"\n  | \"Settled\"\n  | \"Opened\"\n  | \"Paused\"\n  | \"Unknown\";\n\n/**\n * Parse market event type from string.\n */\nexport function parseMarketEventType(s: string): MarketEventType {\n  switch (s) {\n    case \"orderbook_created\":\n      return \"OrderbookCreated\";\n    case \"settled\":\n      return \"Settled\";\n    case \"opened\":\n      return \"Opened\";\n    case \"paused\":\n      return \"Paused\";\n    default:\n      return \"Unknown\";\n  }\n}\n\n// ============================================================================\n// ERROR TYPES\n// ============================================================================\n\n/**\n * Error response from server.\n */\nexport interface ErrorData {\n  error: string;\n  code: string;\n  orderbook_id?: string;\n}\n\n/**\n * Server error codes.\n */\nexport type ErrorCode =\n  | \"EngineUnavailable\"\n  | \"InvalidJson\"\n  | \"InvalidMethod\"\n  | \"RateLimited\"\n  | \"Unknown\";\n\n/**\n * Parse error code from string.\n */\nexport function parseErrorCode(s: string): ErrorCode {\n  switch (s) {\n    case \"ENGINE_UNAVAILABLE\":\n      return \"EngineUnavailable\";\n    case \"INVALID_JSON\":\n      return \"InvalidJson\";\n    case \"INVALID_METHOD\":\n      return \"InvalidMethod\";\n    case \"RATE_LIMITED\":\n      return \"RateLimited\";\n    default:\n      return \"Unknown\";\n  }\n}\n\n// ============================================================================\n// PONG TYPE\n// ============================================================================\n\n/**\n * Pong response data (empty).\n */\nexport interface PongData {}\n\n// ============================================================================\n// CLIENT EVENTS\n// ============================================================================\n\n/**\n * Events emitted by the WebSocket client.\n */\nexport type WsEvent =\n  | { type: \"Connected\" }\n  | { type: \"Disconnected\"; reason: string }\n  | { type: \"BookUpdate\"; orderbookId: string; isSnapshot: boolean }\n  | { type: \"Trade\"; orderbookId: string; trade: TradeData }\n  | { type: \"UserUpdate\"; eventType: string; user: string }\n  | { type: \"PriceUpdate\"; orderbookId: string; resolution: string }\n  | { type: \"MarketEvent\"; eventType: string; marketPubkey: string }\n  | { type: \"Error\"; error: WebSocketError }\n  | { type: \"ResyncRequired\"; orderbookId: string }\n  | { type: \"Pong\" }\n  | { type: \"Reconnecting\"; attempt: number };\n\n// ============================================================================\n// MESSAGE TYPE ENUM\n// ============================================================================\n\n/**\n * Enum for all possible server message types.\n */\nexport type MessageType =\n  | \"BookUpdate\"\n  | \"Trades\"\n  | \"User\"\n  | \"PriceHistory\"\n  | \"Market\"\n  | \"Error\"\n  | \"Pong\"\n  | \"Unknown\";\n\n/**\n * Parse message type from string.\n */\nexport function parseMessageType(s: string): MessageType {\n  switch (s) {\n    case \"book_update\":\n      return \"BookUpdate\";\n    case \"trades\":\n      return \"Trades\";\n    case \"user\":\n      return \"User\";\n    case \"price_history\":\n      return \"PriceHistory\";\n    case \"market\":\n      return \"Market\";\n    case \"error\":\n      return \"Error\";\n    case \"pong\":\n      return \"Pong\";\n    default:\n      return \"Unknown\";\n  }\n}\n\n// ============================================================================\n// SIDE HELPERS\n// ============================================================================\n\n/**\n * Order side enum for user events.\n */\nexport type Side = \"Buy\" | \"Sell\";\n\n/**\n * Parse side from number.\n */\nexport function parseSide(value: number): Side {\n  return value === 0 ? \"Buy\" : \"Sell\";\n}\n\n/**\n * Convert side to number.\n */\nexport function sideToNumber(side: Side): number {\n  return side === \"Buy\" ? 0 : 1;\n}\n\n/**\n * Price level side (from orderbook updates).\n */\nexport type PriceLevelSide = \"Bid\" | \"Ask\";\n\n/**\n * Parse price level side from string.\n */\nexport function parsePriceLevelSide(s: string): PriceLevelSide {\n  return s === \"bid\" ? \"Bid\" : \"Ask\";\n}\n"]}