@lightconexyz/lightcone-sdk 0.1.0

package/dist/websocket/error.d.ts

@@ -0,0 +1,47 @@
+/**
+ * WebSocket error types for the Lightcone WebSocket client.
+ */
+/**
+ * WebSocket error variants.
+ */
+export type WebSocketErrorVariant = "ConnectionFailed" | "ConnectionClosed" | "ConnectionTimeout" | "RateLimited" | "MessageParseError" | "SequenceGap" | "ResyncRequired" | "PingTimeout" | "ServerError" | "AuthenticationFailed" | "ChannelClosed" | "NotConnected" | "InvalidUrl" | "Protocol" | "HttpError";
+/**
+ * WebSocket error class.
+ */
+export declare class WebSocketError extends Error {
+    readonly variant: WebSocketErrorVariant;
+    readonly code?: string;
+    readonly details?: Record<string, unknown>;
+    constructor(variant: WebSocketErrorVariant, message: string, code?: string, details?: Record<string, unknown>);
+    /** Failed to establish connection */
+    static connectionFailed(message: string): WebSocketError;
+    /** Connection timeout */
+    static connectionTimeout(): WebSocketError;
+    /** Connection was closed */
+    static connectionClosed(code: number, reason: string): WebSocketError;
+    /** Rate limit exceeded */
+    static rateLimited(): WebSocketError;
+    /** Failed to parse message */
+    static messageParseError(message: string): WebSocketError;
+    /** Sequence gap detected in orderbook updates */
+    static sequenceGap(expected: number, received: number): WebSocketError;
+    /** Resync required for orderbook */
+    static resyncRequired(orderbookId: string): WebSocketError;
+    /** Ping timeout */
+    static pingTimeout(): WebSocketError;
+    /** Server error */
+    static serverError(code: string, message: string): WebSocketError;
+    /** Authentication failed */
+    static authenticationFailed(message: string): WebSocketError;
+    /** Channel closed */
+    static channelClosed(): WebSocketError;
+    /** Not connected */
+    static notConnected(): WebSocketError;
+    /** Invalid URL */
+    static invalidUrl(message: string): WebSocketError;
+    /** Protocol error */
+    static protocol(message: string): WebSocketError;
+    /** HTTP error during authentication */
+    static httpError(message: string): WebSocketError;
+}
+//# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/websocket/error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,kBAAkB,GAClB,kBAAkB,GAClB,mBAAmB,GACnB,aAAa,GACb,mBAAmB,GACnB,aAAa,GACb,gBAAgB,GAChB,aAAa,GACb,aAAa,GACb,sBAAsB,GACtB,eAAe,GACf,cAAc,GACd,YAAY,GACZ,UAAU,GACV,WAAW,CAAC;AAEhB;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGzC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IASnC,qCAAqC;IACrC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;IAIxD,yBAAyB;IACzB,MAAM,CAAC,iBAAiB,IAAI,cAAc;IAO1C,4BAA4B;IAC5B,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc;IAQrE,0BAA0B;IAC1B,MAAM,CAAC,WAAW,IAAI,cAAc;IAIpC,8BAA8B;IAC9B,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;IAIzD,iDAAiD;IACjD,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc;IAStE,oCAAoC;IACpC,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc;IAS1D,mBAAmB;IACnB,MAAM,CAAC,WAAW,IAAI,cAAc;IAIpC,mBAAmB;IACnB,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc;IAIjE,4BAA4B;IAC5B,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;IAI5D,qBAAqB;IACrB,MAAM,CAAC,aAAa,IAAI,cAAc;IAItC,oBAAoB;IACpB,MAAM,CAAC,YAAY,IAAI,cAAc;IAIrC,kBAAkB;IAClB,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;IAIlD,qBAAqB;IACrB,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;IAIhD,uCAAuC;IACvC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;CAGlD"}

package/dist/websocket/error.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * WebSocket error types for the Lightcone WebSocket client.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketError = void 0;
+/**
+ * WebSocket error class.
+ */
+class WebSocketError extends Error {
+    variant;
+    code;
+    details;
+    constructor(variant, message, code, details) {
+        super(message);
+        this.name = "WebSocketError";
+        this.variant = variant;
+        this.code = code;
+        this.details = details;
+    }
+    /** Failed to establish connection */
+    static connectionFailed(message) {
+        return new WebSocketError("ConnectionFailed", `Connection failed: ${message}`);
+    }
+    /** Connection timeout */
+    static connectionTimeout() {
+        return new WebSocketError("ConnectionTimeout", "Connection timeout - server did not respond");
+    }
+    /** Connection was closed */
+    static connectionClosed(code, reason) {
+        return new WebSocketError("ConnectionClosed", `Connection closed: code ${code}, reason: ${reason}`, String(code));
+    }
+    /** Rate limit exceeded */
+    static rateLimited() {
+        return new WebSocketError("RateLimited", "Rate limited by server");
+    }
+    /** Failed to parse message */
+    static messageParseError(message) {
+        return new WebSocketError("MessageParseError", `Failed to parse message: ${message}`);
+    }
+    /** Sequence gap detected in orderbook updates */
+    static sequenceGap(expected, received) {
+        return new WebSocketError("SequenceGap", `Sequence gap: expected ${expected}, received ${received}`, undefined, { expected, received });
+    }
+    /** Resync required for orderbook */
+    static resyncRequired(orderbookId) {
+        return new WebSocketError("ResyncRequired", `Resync required for orderbook: ${orderbookId}`, undefined, { orderbookId });
+    }
+    /** Ping timeout */
+    static pingTimeout() {
+        return new WebSocketError("PingTimeout", "Ping timeout - no response from server");
+    }
+    /** Server error */
+    static serverError(code, message) {
+        return new WebSocketError("ServerError", `Server error: ${message}`, code);
+    }
+    /** Authentication failed */
+    static authenticationFailed(message) {
+        return new WebSocketError("AuthenticationFailed", `Authentication failed: ${message}`);
+    }
+    /** Channel closed */
+    static channelClosed() {
+        return new WebSocketError("ChannelClosed", "Internal channel closed");
+    }
+    /** Not connected */
+    static notConnected() {
+        return new WebSocketError("NotConnected", "Not connected to server");
+    }
+    /** Invalid URL */
+    static invalidUrl(message) {
+        return new WebSocketError("InvalidUrl", `Invalid URL: ${message}`);
+    }
+    /** Protocol error */
+    static protocol(message) {
+        return new WebSocketError("Protocol", `Protocol error: ${message}`);
+    }
+    /** HTTP error during authentication */
+    static httpError(message) {
+        return new WebSocketError("HttpError", `HTTP error: ${message}`);
+    }
+}
+exports.WebSocketError = WebSocketError;
+//# sourceMappingURL=error.js.map

package/dist/websocket/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/websocket/error.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * WebSocket error types for the Lightcone WebSocket client.\n */\n\n/**\n * WebSocket error variants.\n */\nexport type WebSocketErrorVariant =\n  | \"ConnectionFailed\"\n  | \"ConnectionClosed\"\n  | \"ConnectionTimeout\"\n  | \"RateLimited\"\n  | \"MessageParseError\"\n  | \"SequenceGap\"\n  | \"ResyncRequired\"\n  | \"PingTimeout\"\n  | \"ServerError\"\n  | \"AuthenticationFailed\"\n  | \"ChannelClosed\"\n  | \"NotConnected\"\n  | \"InvalidUrl\"\n  | \"Protocol\"\n  | \"HttpError\";\n\n/**\n * WebSocket error class.\n */\nexport class WebSocketError extends Error {\n  readonly variant: WebSocketErrorVariant;\n  readonly code?: string;\n  readonly details?: Record<string, unknown>;\n\n  constructor(\n    variant: WebSocketErrorVariant,\n    message: string,\n    code?: string,\n    details?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = \"WebSocketError\";\n    this.variant = variant;\n    this.code = code;\n    this.details = details;\n  }\n\n  /** Failed to establish connection */\n  static connectionFailed(message: string): WebSocketError {\n    return new WebSocketError(\"ConnectionFailed\", `Connection failed: ${message}`);\n  }\n\n  /** Connection timeout */\n  static connectionTimeout(): WebSocketError {\n    return new WebSocketError(\n      \"ConnectionTimeout\",\n      \"Connection timeout - server did not respond\"\n    );\n  }\n\n  /** Connection was closed */\n  static connectionClosed(code: number, reason: string): WebSocketError {\n    return new WebSocketError(\n      \"ConnectionClosed\",\n      `Connection closed: code ${code}, reason: ${reason}`,\n      String(code)\n    );\n  }\n\n  /** Rate limit exceeded */\n  static rateLimited(): WebSocketError {\n    return new WebSocketError(\"RateLimited\", \"Rate limited by server\");\n  }\n\n  /** Failed to parse message */\n  static messageParseError(message: string): WebSocketError {\n    return new WebSocketError(\"MessageParseError\", `Failed to parse message: ${message}`);\n  }\n\n  /** Sequence gap detected in orderbook updates */\n  static sequenceGap(expected: number, received: number): WebSocketError {\n    return new WebSocketError(\n      \"SequenceGap\",\n      `Sequence gap: expected ${expected}, received ${received}`,\n      undefined,\n      { expected, received }\n    );\n  }\n\n  /** Resync required for orderbook */\n  static resyncRequired(orderbookId: string): WebSocketError {\n    return new WebSocketError(\n      \"ResyncRequired\",\n      `Resync required for orderbook: ${orderbookId}`,\n      undefined,\n      { orderbookId }\n    );\n  }\n\n  /** Ping timeout */\n  static pingTimeout(): WebSocketError {\n    return new WebSocketError(\"PingTimeout\", \"Ping timeout - no response from server\");\n  }\n\n  /** Server error */\n  static serverError(code: string, message: string): WebSocketError {\n    return new WebSocketError(\"ServerError\", `Server error: ${message}`, code);\n  }\n\n  /** Authentication failed */\n  static authenticationFailed(message: string): WebSocketError {\n    return new WebSocketError(\"AuthenticationFailed\", `Authentication failed: ${message}`);\n  }\n\n  /** Channel closed */\n  static channelClosed(): WebSocketError {\n    return new WebSocketError(\"ChannelClosed\", \"Internal channel closed\");\n  }\n\n  /** Not connected */\n  static notConnected(): WebSocketError {\n    return new WebSocketError(\"NotConnected\", \"Not connected to server\");\n  }\n\n  /** Invalid URL */\n  static invalidUrl(message: string): WebSocketError {\n    return new WebSocketError(\"InvalidUrl\", `Invalid URL: ${message}`);\n  }\n\n  /** Protocol error */\n  static protocol(message: string): WebSocketError {\n    return new WebSocketError(\"Protocol\", `Protocol error: ${message}`);\n  }\n\n  /** HTTP error during authentication */\n  static httpError(message: string): WebSocketError {\n    return new WebSocketError(\"HttpError\", `HTTP error: ${message}`);\n  }\n}\n"]}

package/dist/websocket/handlers.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Message handlers for WebSocket events.
+ *
+ * Routes incoming messages to appropriate handlers and emits events.
+ */
+import { LocalOrderbook, UserState, PriceHistory } from "./state";
+import type { WsEvent } from "./types";
+/**
+ * Handles incoming WebSocket messages.
+ */
+export declare class MessageHandler {
+    /** Local orderbook state */
+    private orderbooks;
+    /** Local user state */
+    private userStates;
+    /** Price history state */
+    private priceHistories;
+    /** Currently subscribed user (single user per connection) */
+    private subscribedUser;
+    /**
+     * Handle an incoming message and return events.
+     */
+    handleMessage(text: string): WsEvent[];
+    /**
+     * Handle book update message.
+     */
+    private handleBookUpdate;
+    /**
+     * Handle trade message.
+     */
+    private handleTrade;
+    /**
+     * Handle user event message.
+     */
+    private handleUserEvent;
+    /**
+     * Handle price history message.
+     */
+    private handlePriceHistory;
+    /**
+     * Handle market event message.
+     */
+    private handleMarketEvent;
+    /**
+     * Handle error message from server.
+     */
+    private handleError;
+    /**
+     * Handle auth message.
+     */
+    private handleAuth;
+    /**
+     * Initialize orderbook state for a subscription.
+     */
+    initOrderbook(orderbookId: string): void;
+    /**
+     * Initialize user state for a subscription.
+     */
+    initUserState(user: string): void;
+    /**
+     * Clear the subscribed user.
+     */
+    clearSubscribedUser(user: string): void;
+    /**
+     * Initialize price history state for a subscription.
+     */
+    initPriceHistory(orderbookId: string, resolution: string, includeOhlcv: boolean): void;
+    /**
+     * Get orderbook state.
+     */
+    getOrderbook(orderbookId: string): LocalOrderbook | undefined;
+    /**
+     * Get user state.
+     */
+    getUserState(user: string): UserState | undefined;
+    /**
+     * Get price history state.
+     */
+    getPriceHistory(orderbookId: string, resolution: string): PriceHistory | undefined;
+    /**
+     * Clear orderbook state.
+     */
+    clearOrderbook(orderbookId: string): void;
+    /**
+     * Clear user state.
+     */
+    clearUserState(user: string): void;
+    /**
+     * Clear price history state.
+     */
+    clearPriceHistory(orderbookId: string, resolution: string): void;
+    /**
+     * Clear all state.
+     */
+    clearAll(): void;
+}
+//# sourceMappingURL=handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/websocket/handlers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,KAAK,EACV,OAAO,EAQR,MAAM,SAAS,CAAC;AAGjB;;GAEG;AACH,qBAAa,cAAc;IACzB,4BAA4B;IAC5B,OAAO,CAAC,UAAU,CAA0C;IAC5D,uBAAuB;IACvB,OAAO,CAAC,UAAU,CAAqC;IACvD,0BAA0B;IAC1B,OAAO,CAAC,cAAc,CAAwC;IAC9D,6DAA6D;IAC7D,OAAO,CAAC,cAAc,CAAuB;IAE7C;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE;IAmCtC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkCxB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,eAAe;IAsBvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoC1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,UAAU;IAalB;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAMxC;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOjC;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMvC;;OAEG;IACH,gBAAgB,CACd,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,OAAO,GACpB,IAAI;IAUP;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7D;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIjD;;OAEG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAKlF;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAOzC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOlC;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAQhE;;OAEG;IACH,QAAQ,IAAI,IAAI;CAKjB"}

package/dist/websocket/handlers.js

@@ -0,0 +1,277 @@
+"use strict";
+/**
+ * Message handlers for WebSocket events.
+ *
+ * Routes incoming messages to appropriate handlers and emits events.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageHandler = void 0;
+const error_1 = require("./error");
+const state_1 = require("./state");
+const types_1 = require("./types");
+/**
+ * Handles incoming WebSocket messages.
+ */
+class MessageHandler {
+    /** Local orderbook state */
+    orderbooks = new Map();
+    /** Local user state */
+    userStates = new Map();
+    /** Price history state */
+    priceHistories = new Map();
+    /** Currently subscribed user (single user per connection) */
+    subscribedUser = null;
+    /**
+     * Handle an incoming message and return events.
+     */
+    handleMessage(text) {
+        const msg = (0, types_1.parseWsMessage)(text);
+        if (!msg) {
+            return [
+                {
+                    type: "Error",
+                    error: error_1.WebSocketError.messageParseError("Invalid message"),
+                },
+            ];
+        }
+        // TypeScript narrows msg.data type automatically based on msg.type
+        switch (msg.type) {
+            case "book_update":
+                return this.handleBookUpdate(msg.data);
+            case "trades":
+                return this.handleTrade(msg.data);
+            case "user":
+                return this.handleUserEvent(msg.data);
+            case "price_history":
+                return this.handlePriceHistory(msg.data);
+            case "market":
+                return this.handleMarketEvent(msg.data);
+            case "error":
+                return this.handleError(msg.data);
+            case "pong":
+                return [{ type: "Pong" }];
+            case "auth":
+                return this.handleAuth(msg.data);
+            default:
+                console.warn("Unknown message type:", msg.type);
+                return [];
+        }
+    }
+    /**
+     * Handle book update message.
+     */
+    handleBookUpdate(data) {
+        // Check for resync signal
+        if (data.resync) {
+            console.info("Resync required for orderbook:", data.orderbook_id);
+            return [{ type: "ResyncRequired", orderbookId: data.orderbook_id }];
+        }
+        const orderbookId = data.orderbook_id;
+        const isSnapshot = data.is_snapshot;
+        // Update local state
+        let book = this.orderbooks.get(orderbookId);
+        if (!book) {
+            book = new state_1.LocalOrderbook(orderbookId);
+            this.orderbooks.set(orderbookId, book);
+        }
+        try {
+            book.applyUpdate(data);
+            return [{ type: "BookUpdate", orderbookId, isSnapshot }];
+        }
+        catch (e) {
+            if (e instanceof error_1.WebSocketError && e.variant === "SequenceGap") {
+                console.warn(`Sequence gap in orderbook ${orderbookId}:`, e.message);
+                // Clear the orderbook state on sequence gap
+                book.clear();
+                return [{ type: "ResyncRequired", orderbookId }];
+            }
+            return [{ type: "Error", error: e }];
+        }
+    }
+    /**
+     * Handle trade message.
+     */
+    handleTrade(data) {
+        return [{ type: "Trade", orderbookId: data.orderbook_id, trade: data }];
+    }
+    /**
+     * Handle user event message.
+     */
+    handleUserEvent(data) {
+        const eventType = data.event_type;
+        // Use the tracked subscribed user (single user per connection)
+        const user = this.subscribedUser;
+        if (!user) {
+            console.warn(`Received user event '${eventType}' but no user subscription exists. ` +
+                `Call subscribeUser() before receiving events to avoid data loss.`);
+            return [{ type: "UserUpdate", eventType, user: "unknown" }];
+        }
+        // Update local state for the subscribed user
+        const state = this.userStates.get(user);
+        if (state) {
+            state.applyEvent(data);
+        }
+        return [{ type: "UserUpdate", eventType, user }];
+    }
+    /**
+     * Handle price history message.
+     */
+    handlePriceHistory(data) {
+        // Heartbeats don't have orderbook_id
+        if (data.event_type === "heartbeat") {
+            // Update all price histories with heartbeat
+            for (const history of this.priceHistories.values()) {
+                history.applyHeartbeat(data);
+            }
+            return [];
+        }
+        const orderbookId = data.orderbook_id;
+        if (!orderbookId) {
+            console.warn("Price history message missing orderbook_id");
+            return [];
+        }
+        const resolution = data.resolution || "1m";
+        const key = `${orderbookId}:${resolution}`;
+        let history = this.priceHistories.get(key);
+        if (history) {
+            history.applyEvent(data);
+        }
+        else if (data.event_type === "snapshot") {
+            // Create new history if this is a snapshot
+            history = new state_1.PriceHistory(orderbookId, resolution, data.include_ohlcv || false);
+            history.applyEvent(data);
+            this.priceHistories.set(key, history);
+        }
+        return [{ type: "PriceUpdate", orderbookId, resolution }];
+    }
+    /**
+     * Handle market event message.
+     */
+    handleMarketEvent(data) {
+        return [
+            {
+                type: "MarketEvent",
+                eventType: data.event_type,
+                marketPubkey: data.market_pubkey,
+            },
+        ];
+    }
+    /**
+     * Handle error message from server.
+     */
+    handleError(data) {
+        console.error(`Server error: ${data.error} (code: ${data.code})`);
+        return [
+            {
+                type: "Error",
+                error: error_1.WebSocketError.serverError(data.code, data.error),
+            },
+        ];
+    }
+    /**
+     * Handle auth message.
+     */
+    handleAuth(data) {
+        if (data.status === "error") {
+            return [
+                {
+                    type: "Error",
+                    error: error_1.WebSocketError.authenticationFailed(data.message || "Authentication failed"),
+                },
+            ];
+        }
+        // For authenticated/anonymous, just log and continue
+        return [];
+    }
+    /**
+     * Initialize orderbook state for a subscription.
+     */
+    initOrderbook(orderbookId) {
+        if (!this.orderbooks.has(orderbookId)) {
+            this.orderbooks.set(orderbookId, new state_1.LocalOrderbook(orderbookId));
+        }
+    }
+    /**
+     * Initialize user state for a subscription.
+     */
+    initUserState(user) {
+        this.subscribedUser = user;
+        if (!this.userStates.has(user)) {
+            this.userStates.set(user, new state_1.UserState(user));
+        }
+    }
+    /**
+     * Clear the subscribed user.
+     */
+    clearSubscribedUser(user) {
+        if (this.subscribedUser === user) {
+            this.subscribedUser = null;
+        }
+    }
+    /**
+     * Initialize price history state for a subscription.
+     */
+    initPriceHistory(orderbookId, resolution, includeOhlcv) {
+        const key = `${orderbookId}:${resolution}`;
+        if (!this.priceHistories.has(key)) {
+            this.priceHistories.set(key, new state_1.PriceHistory(orderbookId, resolution, includeOhlcv));
+        }
+    }
+    /**
+     * Get orderbook state.
+     */
+    getOrderbook(orderbookId) {
+        return this.orderbooks.get(orderbookId);
+    }
+    /**
+     * Get user state.
+     */
+    getUserState(user) {
+        return this.userStates.get(user);
+    }
+    /**
+     * Get price history state.
+     */
+    getPriceHistory(orderbookId, resolution) {
+        const key = `${orderbookId}:${resolution}`;
+        return this.priceHistories.get(key);
+    }
+    /**
+     * Clear orderbook state.
+     */
+    clearOrderbook(orderbookId) {
+        const book = this.orderbooks.get(orderbookId);
+        if (book) {
+            book.clear();
+        }
+    }
+    /**
+     * Clear user state.
+     */
+    clearUserState(user) {
+        const state = this.userStates.get(user);
+        if (state) {
+            state.clear();
+        }
+    }
+    /**
+     * Clear price history state.
+     */
+    clearPriceHistory(orderbookId, resolution) {
+        const key = `${orderbookId}:${resolution}`;
+        const history = this.priceHistories.get(key);
+        if (history) {
+            history.clear();
+        }
+    }
+    /**
+     * Clear all state.
+     */
+    clearAll() {
+        this.orderbooks.clear();
+        this.userStates.clear();
+        this.priceHistories.clear();
+    }
+}
+exports.MessageHandler = MessageHandler;
+//# sourceMappingURL=handlers.js.map

package/dist/websocket/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/websocket/handlers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Message handlers for WebSocket events.\n *\n * Routes incoming messages to appropriate handlers and emits events.\n */\n\nimport { WebSocketError } from \"./error\";\nimport { LocalOrderbook, UserState, PriceHistory } from \"./state\";\nimport type {\n  WsEvent,\n  BookUpdateData,\n  TradeData,\n  UserEventData,\n  PriceHistoryData,\n  MarketEventData,\n  ErrorData,\n  AuthData,\n} from \"./types\";\nimport { parseWsMessage } from \"./types\";\n\n/**\n * Handles incoming WebSocket messages.\n */\nexport class MessageHandler {\n  /** Local orderbook state */\n  private orderbooks: Map<string, LocalOrderbook> = new Map();\n  /** Local user state */\n  private userStates: Map<string, UserState> = new Map();\n  /** Price history state */\n  private priceHistories: Map<string, PriceHistory> = new Map();\n  /** Currently subscribed user (single user per connection) */\n  private subscribedUser: string | null = null;\n\n  /**\n   * Handle an incoming message and return events.\n   */\n  handleMessage(text: string): WsEvent[] {\n    const msg = parseWsMessage(text);\n    if (!msg) {\n      return [\n        {\n          type: \"Error\",\n          error: WebSocketError.messageParseError(\"Invalid message\"),\n        },\n      ];\n    }\n\n    // TypeScript narrows msg.data type automatically based on msg.type\n    switch (msg.type) {\n      case \"book_update\":\n        return this.handleBookUpdate(msg.data);\n      case \"trades\":\n        return this.handleTrade(msg.data);\n      case \"user\":\n        return this.handleUserEvent(msg.data);\n      case \"price_history\":\n        return this.handlePriceHistory(msg.data);\n      case \"market\":\n        return this.handleMarketEvent(msg.data);\n      case \"error\":\n        return this.handleError(msg.data);\n      case \"pong\":\n        return [{ type: \"Pong\" }];\n      case \"auth\":\n        return this.handleAuth(msg.data);\n      default:\n        console.warn(\"Unknown message type:\", (msg as { type: string }).type);\n        return [];\n    }\n  }\n\n  /**\n   * Handle book update message.\n   */\n  private handleBookUpdate(data: BookUpdateData): WsEvent[] {\n    // Check for resync signal\n    if (data.resync) {\n      console.info(\"Resync required for orderbook:\", data.orderbook_id);\n      return [{ type: \"ResyncRequired\", orderbookId: data.orderbook_id }];\n    }\n\n    const orderbookId = data.orderbook_id;\n    const isSnapshot = data.is_snapshot;\n\n    // Update local state\n    let book = this.orderbooks.get(orderbookId);\n    if (!book) {\n      book = new LocalOrderbook(orderbookId);\n      this.orderbooks.set(orderbookId, book);\n    }\n\n    try {\n      book.applyUpdate(data);\n      return [{ type: \"BookUpdate\", orderbookId, isSnapshot }];\n    } catch (e) {\n      if (e instanceof WebSocketError && e.variant === \"SequenceGap\") {\n        console.warn(\n          `Sequence gap in orderbook ${orderbookId}:`,\n          e.message\n        );\n        // Clear the orderbook state on sequence gap\n        book.clear();\n        return [{ type: \"ResyncRequired\", orderbookId }];\n      }\n      return [{ type: \"Error\", error: e as WebSocketError }];\n    }\n  }\n\n  /**\n   * Handle trade message.\n   */\n  private handleTrade(data: TradeData): WsEvent[] {\n    return [{ type: \"Trade\", orderbookId: data.orderbook_id, trade: data }];\n  }\n\n  /**\n   * Handle user event message.\n   */\n  private handleUserEvent(data: UserEventData): WsEvent[] {\n    const eventType = data.event_type;\n\n    // Use the tracked subscribed user (single user per connection)\n    const user = this.subscribedUser;\n    if (!user) {\n      console.warn(\n        `Received user event '${eventType}' but no user subscription exists. ` +\n          `Call subscribeUser() before receiving events to avoid data loss.`\n      );\n      return [{ type: \"UserUpdate\", eventType, user: \"unknown\" }];\n    }\n\n    // Update local state for the subscribed user\n    const state = this.userStates.get(user);\n    if (state) {\n      state.applyEvent(data);\n    }\n\n    return [{ type: \"UserUpdate\", eventType, user }];\n  }\n\n  /**\n   * Handle price history message.\n   */\n  private handlePriceHistory(data: PriceHistoryData): WsEvent[] {\n    // Heartbeats don't have orderbook_id\n    if (data.event_type === \"heartbeat\") {\n      // Update all price histories with heartbeat\n      for (const history of this.priceHistories.values()) {\n        history.applyHeartbeat(data);\n      }\n      return [];\n    }\n\n    const orderbookId = data.orderbook_id;\n    if (!orderbookId) {\n      console.warn(\"Price history message missing orderbook_id\");\n      return [];\n    }\n\n    const resolution = data.resolution || \"1m\";\n    const key = `${orderbookId}:${resolution}`;\n\n    let history = this.priceHistories.get(key);\n    if (history) {\n      history.applyEvent(data);\n    } else if (data.event_type === \"snapshot\") {\n      // Create new history if this is a snapshot\n      history = new PriceHistory(\n        orderbookId,\n        resolution,\n        data.include_ohlcv || false\n      );\n      history.applyEvent(data);\n      this.priceHistories.set(key, history);\n    }\n\n    return [{ type: \"PriceUpdate\", orderbookId, resolution }];\n  }\n\n  /**\n   * Handle market event message.\n   */\n  private handleMarketEvent(data: MarketEventData): WsEvent[] {\n    return [\n      {\n        type: \"MarketEvent\",\n        eventType: data.event_type,\n        marketPubkey: data.market_pubkey,\n      },\n    ];\n  }\n\n  /**\n   * Handle error message from server.\n   */\n  private handleError(data: ErrorData): WsEvent[] {\n    console.error(`Server error: ${data.error} (code: ${data.code})`);\n    return [\n      {\n        type: \"Error\",\n        error: WebSocketError.serverError(data.code, data.error),\n      },\n    ];\n  }\n\n  /**\n   * Handle auth message.\n   */\n  private handleAuth(data: AuthData): WsEvent[] {\n    if (data.status === \"error\") {\n      return [\n        {\n          type: \"Error\",\n          error: WebSocketError.authenticationFailed(data.message || \"Authentication failed\"),\n        },\n      ];\n    }\n    // For authenticated/anonymous, just log and continue\n    return [];\n  }\n\n  /**\n   * Initialize orderbook state for a subscription.\n   */\n  initOrderbook(orderbookId: string): void {\n    if (!this.orderbooks.has(orderbookId)) {\n      this.orderbooks.set(orderbookId, new LocalOrderbook(orderbookId));\n    }\n  }\n\n  /**\n   * Initialize user state for a subscription.\n   */\n  initUserState(user: string): void {\n    this.subscribedUser = user;\n    if (!this.userStates.has(user)) {\n      this.userStates.set(user, new UserState(user));\n    }\n  }\n\n  /**\n   * Clear the subscribed user.\n   */\n  clearSubscribedUser(user: string): void {\n    if (this.subscribedUser === user) {\n      this.subscribedUser = null;\n    }\n  }\n\n  /**\n   * Initialize price history state for a subscription.\n   */\n  initPriceHistory(\n    orderbookId: string,\n    resolution: string,\n    includeOhlcv: boolean\n  ): void {\n    const key = `${orderbookId}:${resolution}`;\n    if (!this.priceHistories.has(key)) {\n      this.priceHistories.set(\n        key,\n        new PriceHistory(orderbookId, resolution, includeOhlcv)\n      );\n    }\n  }\n\n  /**\n   * Get orderbook state.\n   */\n  getOrderbook(orderbookId: string): LocalOrderbook | undefined {\n    return this.orderbooks.get(orderbookId);\n  }\n\n  /**\n   * Get user state.\n   */\n  getUserState(user: string): UserState | undefined {\n    return this.userStates.get(user);\n  }\n\n  /**\n   * Get price history state.\n   */\n  getPriceHistory(orderbookId: string, resolution: string): PriceHistory | undefined {\n    const key = `${orderbookId}:${resolution}`;\n    return this.priceHistories.get(key);\n  }\n\n  /**\n   * Clear orderbook state.\n   */\n  clearOrderbook(orderbookId: string): void {\n    const book = this.orderbooks.get(orderbookId);\n    if (book) {\n      book.clear();\n    }\n  }\n\n  /**\n   * Clear user state.\n   */\n  clearUserState(user: string): void {\n    const state = this.userStates.get(user);\n    if (state) {\n      state.clear();\n    }\n  }\n\n  /**\n   * Clear price history state.\n   */\n  clearPriceHistory(orderbookId: string, resolution: string): void {\n    const key = `${orderbookId}:${resolution}`;\n    const history = this.priceHistories.get(key);\n    if (history) {\n      history.clear();\n    }\n  }\n\n  /**\n   * Clear all state.\n   */\n  clearAll(): void {\n    this.orderbooks.clear();\n    this.userStates.clear();\n    this.priceHistories.clear();\n  }\n}\n"]}

package/dist/websocket/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * WebSocket client module for Lightcone.
+ *
+ * This module provides real-time data streaming functionality for
+ * live orderbook updates, trade notifications, and market events.
+ *
+ * @example
+ * ```typescript
+ * import { websocket } from "@lightcone/sdk";
+ *
+ * const client = await websocket.LightconeWebSocketClient.connectDefault();
+ *
+ * client.on((event) => {
+ *   if (event.type === "BookUpdate") {
+ *     const book = client.getOrderbook(event.orderbookId);
+ *     console.log("Best bid:", book?.bestBid());
+ *   }
+ * });
+ *
+ * await client.subscribeBookUpdates(["market1:ob1"]);
+ * ```
+ *
+ * @module websocket
+ */
+export { LightconeWebSocketClient, DEFAULT_WS_URL, } from "./client";
+export type { WebSocketConfig, ConnectionState, EventCallback, } from "./client";
+export { WebSocketError } from "./error";
+export type { WebSocketErrorVariant } from "./error";
+export type { WsRequest, SubscribeParams, BookUpdateParams, TradesParams, UserParams, PriceHistoryParams, MarketParams, WsServerMessage, AuthData, WsMessage, BookUpdateData, PriceLevel, TradeData, UserEventData, Order, OrderUpdate, Balance, OutcomeBalance, BalanceEntry, PriceHistoryData, Candle, MarketEventData, MarketEventType, ErrorData, ErrorCode, PongData, WsEvent, MessageType, Side, PriceLevelSide, } from "./types";
+export { createSubscribeRequest, createUnsubscribeRequest, createPingRequest, bookUpdateParams, tradesParams, userParams, priceHistoryParams, marketParams, toCandle, parseMarketEventType, parseErrorCode, parseMessageType, parseWsMessage, parseSide, sideToNumber, parsePriceLevelSide, } from "./types";
+export { LocalOrderbook, UserState, PriceHistory, PriceHistoryKey } from "./state";
+export { SubscriptionManager, subscriptionToParams, subscriptionType } from "./subscriptions";
+export type { Subscription } from "./subscriptions";
+export { MessageHandler } from "./handlers";
+export { authenticate, generateSigninMessage, generateSigninMessageWithTimestamp, signMessage, } from "../auth";
+export type { AuthCredentials } from "../auth";
+export { DEFAULT_API_URL } from "../network";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/websocket/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EACL,wBAAwB,EACxB,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,eAAe,EACf,eAAe,EACf,aAAa,GACd,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,YAAY,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGrD,YAAY,EACV,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,SAAS,EACT,cAAc,EACd,UAAU,EACV,SAAS,EACT,aAAa,EACb,KAAK,EACL,WAAW,EACX,OAAO,EACP,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,MAAM,EACN,eAAe,EACf,eAAe,EACf,SAAS,EACT,SAAS,EACT,QAAQ,EACR,OAAO,EACP,WAAW,EACX,IAAI,EACJ,cAAc,GACf,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,QAAQ,EACR,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,YAAY,EACZ,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAGnF,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC9F,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,kCAAkC,EAClC,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}