@lightconexyz/lightcone-sdk 0.1.0 → 0.2.0

package/dist/websocket/client.d.ts

@@ -1,238 +0,0 @@
-/**
- * Main WebSocket client implementation.
- *
- * Provides a WebSocket client for real-time data streaming.
- */
-import { Keypair } from "@solana/web3.js";
-import type { LocalOrderbook, UserState, PriceHistory } from "./state";
-import type { WsEvent } from "./types";
-import { type AuthCredentials } from "../auth";
-export { DEFAULT_WS_URL } from "../network";
-/**
- * WebSocket client configuration.
- */
-export interface WebSocketConfig {
-    /** Number of reconnect attempts before giving up */
-    reconnectAttempts?: number;
-    /** Base delay for exponential backoff (ms) */
-    baseDelayMs?: number;
-    /** Maximum delay for exponential backoff (ms) */
-    maxDelayMs?: number;
-    /** Interval for client ping (seconds) */
-    pingIntervalSecs?: number;
-    /** Timeout for pong response (seconds) - if no pong received within this time, reconnect */
-    pongTimeoutSecs?: number;
-    /** Whether to automatically reconnect on disconnect */
-    autoReconnect?: boolean;
-    /** Whether to automatically re-subscribe after reconnect */
-    autoResubscribe?: boolean;
-    /** Optional authentication token for private user streams */
-    authToken?: string;
-    /** Connection timeout in milliseconds (default: 30000) */
-    connectionTimeoutMs?: number;
-}
-/**
- * Connection state.
- */
-export type ConnectionState = "Disconnected" | "Connecting" | "Connected" | "Reconnecting" | "Disconnecting";
-/**
- * Event callback type.
- */
-export type EventCallback = (event: WsEvent) => void | Promise<void>;
-/**
- * Main WebSocket client for Lightcone.
- *
- * @example
- * ```typescript
- * import { LightconeWebSocketClient } from "@lightcone/sdk/websocket";
- *
- * const client = new LightconeWebSocketClient();
- * await client.connect();
- *
- * client.on((event) => {
- *   if (event.type === "BookUpdate") {
- *     const book = client.getOrderbook(event.orderbookId);
- *     console.log("Best bid:", book?.bestBid());
- *   }
- * });
- *
- * await client.subscribeBookUpdates(["market1:ob1"]);
- * ```
- */
-export declare class LightconeWebSocketClient {
-    private url;
-    private config;
-    private state;
-    private ws;
-    private subscriptions;
-    private handler;
-    private reconnectAttempt;
-    private pingInterval;
-    private eventCallbacks;
-    private authCredentials?;
-    private subscribedUser;
-    private lastPong;
-    private awaitingPong;
-    private isReconnecting;
-    constructor(url?: string, config?: WebSocketConfig);
-    /**
-     * Create a client connected to the default URL.
-     */
-    static connectDefault(): Promise<LightconeWebSocketClient>;
-    /**
-     * Create a client connected to a custom URL.
-     */
-    static connect(url: string, config?: WebSocketConfig): Promise<LightconeWebSocketClient>;
-    /**
-     * Create an authenticated client connected to the default URL.
-     */
-    static connectAuthenticated(keypair: Keypair): Promise<LightconeWebSocketClient>;
-    /**
-     * Create an authenticated client with custom config.
-     */
-    static connectAuthenticatedWithConfig(keypair: Keypair, config: WebSocketConfig): Promise<LightconeWebSocketClient>;
-    /**
-     * Connect to the WebSocket server.
-     */
-    connect(): Promise<void>;
-    /**
-     * Establish the WebSocket connection.
-     */
-    private establishConnection;
-    /**
-     * Attempt to reconnect.
-     */
-    private attemptReconnect;
-    /**
-     * Start the ping interval.
-     */
-    private startPingInterval;
-    /**
-     * Stop the ping interval.
-     */
-    private stopPingInterval;
-    /**
-     * Sleep for a given number of milliseconds.
-     */
-    private sleep;
-    /**
-     * Send a WebSocket message.
-     */
-    private send;
-    /**
-     * Emit an event to all callbacks.
-     */
-    private emitEvent;
-    /**
-     * Subscribe to orderbook updates.
-     */
-    subscribeBookUpdates(orderbookIds: string[]): void;
-    /**
-     * Subscribe to trade executions.
-     */
-    subscribeTrades(orderbookIds: string[]): void;
-    /**
-     * Subscribe to user events.
-     */
-    subscribeUser(user: string): void;
-    /**
-     * Subscribe to price history.
-     */
-    subscribePriceHistory(orderbookId: string, resolution: string, includeOhlcv: boolean): void;
-    /**
-     * Subscribe to market events.
-     */
-    subscribeMarket(marketPubkey: string): void;
-    /**
-     * Unsubscribe from orderbook updates.
-     */
-    unsubscribeBookUpdates(orderbookIds: string[]): void;
-    /**
-     * Unsubscribe from trades.
-     */
-    unsubscribeTrades(orderbookIds: string[]): void;
-    /**
-     * Unsubscribe from user events.
-     */
-    unsubscribeUser(user: string): void;
-    /**
-     * Unsubscribe from price history.
-     */
-    unsubscribePriceHistory(orderbookId: string, resolution: string): void;
-    /**
-     * Unsubscribe from market events.
-     */
-    unsubscribeMarket(marketPubkey: string): void;
-    /**
-     * Send a ping request.
-     */
-    ping(): void;
-    /**
-     * Disconnect from the server.
-     * Returns a Promise that resolves when the connection is fully closed.
-     */
-    disconnect(): Promise<void>;
-    /**
-     * Check if connected.
-     */
-    isConnected(): boolean;
-    /**
-     * Check if authenticated.
-     */
-    isAuthenticated(): boolean;
-    /**
-     * Check if the WebSocket connection is healthy.
-     */
-    isHealthy(): boolean;
-    /**
-     * Get detailed connection status.
-     */
-    getConnectionStatus(): {
-        state: ConnectionState;
-        isHealthy: boolean;
-        lastPongMs: number;
-        awaitingPong: boolean;
-        wsReadyState: number | null;
-    };
-    /**
-     * Get the current connection state.
-     */
-    connectionState(): ConnectionState;
-    /**
-     * 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;
-    /**
-     * Get auth credentials (if authenticated).
-     */
-    getAuthCredentials(): AuthCredentials | undefined;
-    /**
-     * Get user public key (if authenticated).
-     */
-    userPubkey(): string | undefined;
-    /**
-     * Register an event callback.
-     */
-    on(callback: EventCallback): void;
-    /**
-     * Remove an event callback.
-     */
-    off(callback: EventCallback): void;
-    /**
-     * Get the WebSocket URL.
-     */
-    getUrl(): string;
-    /**
-     * Get the configuration.
-     */
-    getConfig(): Required<WebSocketConfig>;
-}
-//# sourceMappingURL=client.d.ts.map

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

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