@adaptic/utils 0.0.383 → 0.1.0

package/dist/types/alpaca/streams/option-stream.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Option Data Stream Module
+ * Real-time options quotes, trades, and bars via Alpaca WebSocket
+ *
+ * Uses the official Alpaca SDK option_stream for reliable real-time data.
+ * Provides automatic reconnection, subscription management, and type-safe events.
+ */
+import { EventEmitter } from 'events';
+import { AlpacaClient } from '../client';
+import { AlpacaOptionTradeStream, AlpacaOptionQuoteStream, AlpacaOptionBarStream, AlpacaOptionStreamMessage } from '../../types/alpaca-types';
+import { StreamConfig, StreamState, SubscriptionRequest } from './base-stream';
+/**
+ * Option stream data feed type
+ */
+export type OptionDataFeed = 'opra' | 'indicative';
+/**
+ * Option stream configuration
+ */
+export interface OptionStreamConfig extends StreamConfig {
+    /** Data feed to use */
+    feed: OptionDataFeed;
+}
+/**
+ * Default option stream configuration
+ */
+export declare const DEFAULT_OPTION_STREAM_CONFIG: Partial<OptionStreamConfig>;
+/**
+ * Option stream event map for type-safe event handling
+ */
+export interface OptionStreamEventMap {
+    trade: AlpacaOptionTradeStream;
+    quote: AlpacaOptionQuoteStream;
+    bar: AlpacaOptionBarStream;
+    data: AlpacaOptionStreamMessage;
+    subscription: {
+        trades: string[];
+        quotes: string[];
+    };
+    authenticated: void;
+    connected: void;
+    disconnected: {
+        code: number;
+        reason: string;
+    };
+    stateChange: StreamState;
+    error: Error;
+}
+/**
+ * Option Data Stream class for receiving real-time options market data
+ * Uses the official Alpaca SDK option_stream for WebSocket management.
+ */
+export declare class OptionDataStream extends EventEmitter {
+    private client;
+    private socket;
+    private state;
+    private feed;
+    private config;
+    private subscriptions;
+    private pendingSubscriptions;
+    constructor(client: AlpacaClient, config?: Partial<OptionStreamConfig>);
+    /**
+     * Log helper
+     */
+    private log;
+    /**
+     * Get the current stream state
+     */
+    getState(): StreamState;
+    /**
+     * Check if stream is connected and authenticated
+     */
+    isStreamConnected(): boolean;
+    /**
+     * Get current subscriptions
+     */
+    getSubscriptions(): SubscriptionRequest;
+    /**
+     * Set the data feed
+     */
+    setFeed(feed: OptionDataFeed): void;
+    /**
+     * Get the current data feed
+     */
+    getFeed(): OptionDataFeed;
+    /**
+     * Connect to the option data stream using SDK
+     */
+    connect(): Promise<void>;
+    /**
+     * Set up all data event handlers for SDK
+     */
+    private setupDataHandlers;
+    /**
+     * Disconnect from the option data stream
+     */
+    disconnect(): void;
+    /**
+     * Subscribe to market data
+     */
+    subscribe(request: SubscriptionRequest): void;
+    /**
+     * Unsubscribe from market data
+     */
+    unsubscribe(request: SubscriptionRequest): void;
+    /**
+     * Subscribe to option trades
+     */
+    subscribeTrades(symbols: string[]): void;
+    /**
+     * Subscribe to option quotes
+     */
+    subscribeQuotes(symbols: string[]): void;
+    /**
+     * Subscribe to option bars (not supported by SDK - logs warning)
+     */
+    subscribeBars(symbols: string[]): void;
+    /**
+     * Subscribe to all data types for option symbols
+     */
+    subscribeAll(symbols: string[]): void;
+    /**
+     * Unsubscribe from option trades
+     */
+    unsubscribeTrades(symbols: string[]): void;
+    /**
+     * Unsubscribe from option quotes
+     */
+    unsubscribeQuotes(symbols: string[]): void;
+    /**
+     * Unsubscribe from option bars (not supported)
+     */
+    unsubscribeBars(symbols: string[]): void;
+    /**
+     * Unsubscribe from all data types for option symbols
+     */
+    unsubscribeAll(symbols: string[]): void;
+    /**
+     * Subscribe to options by underlying symbol
+     * @param underlying The underlying stock symbol (not used in this implementation)
+     * @param contracts Array of option contract symbols to subscribe to
+     */
+    subscribeByUnderlying(underlying: string, contracts: string[]): void;
+    /**
+     * Send subscription request using SDK methods
+     */
+    private sendSubscription;
+    /**
+     * Send unsubscription request using SDK methods
+     */
+    private sendUnsubscription;
+    private convertTrade;
+    private convertQuote;
+    /**
+     * Type-safe event listener registration
+     */
+    on<K extends keyof OptionStreamEventMap>(event: K, listener: (data: OptionStreamEventMap[K]) => void): this;
+    /**
+     * Type-safe event emitter
+     */
+    emit<K extends keyof OptionStreamEventMap>(event: K, data?: OptionStreamEventMap[K]): boolean;
+}
+/**
+ * Create an option data stream for a client
+ */
+export declare function createOptionDataStream(client: AlpacaClient, config?: Partial<OptionStreamConfig>): OptionDataStream;
+export default OptionDataStream;
+//# sourceMappingURL=option-stream.d.ts.map

package/dist/types/alpaca/streams/option-stream.d.ts.map

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

package/dist/types/alpaca/streams/stock-stream.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Stock Data Stream Module
+ * Real-time stock quotes, trades, and bars via Alpaca WebSocket
+ *
+ * Uses the official Alpaca SDK data_stream_v2 for reliable real-time data.
+ * Provides automatic reconnection, subscription management, and type-safe events.
+ */
+import { EventEmitter } from 'events';
+import { AlpacaClient } from '../client';
+import { AlpacaTradeStream, AlpacaQuoteStream, AlpacaBarStream, AlpacaDailyBarStream, AlpacaUpdatedBarStream, AlpacaTradingStatusStream, AlpacaLULDStream, AlpacaTradeCorrectionStream, AlpacaTradeCancelStream, AlpacaOrderImbalanceStream, AlpacaStockStreamMessage } from '../../types/alpaca-types';
+import { StreamConfig, StreamState, SubscriptionRequest } from './base-stream';
+/**
+ * Stock stream data feed type
+ */
+export type StockDataFeed = 'sip' | 'iex' | 'test';
+/**
+ * Stock stream configuration
+ */
+export interface StockStreamConfig extends StreamConfig {
+    /** Data feed to use */
+    feed: StockDataFeed;
+}
+/**
+ * Default stock stream configuration
+ */
+export declare const DEFAULT_STOCK_STREAM_CONFIG: Partial<StockStreamConfig>;
+/**
+ * Stock stream event map for type-safe event handling
+ */
+export interface StockStreamEventMap {
+    trade: AlpacaTradeStream;
+    quote: AlpacaQuoteStream;
+    bar: AlpacaBarStream;
+    dailyBar: AlpacaDailyBarStream;
+    updatedBar: AlpacaUpdatedBarStream;
+    tradingStatus: AlpacaTradingStatusStream;
+    luld: AlpacaLULDStream;
+    tradeCorrection: AlpacaTradeCorrectionStream;
+    tradeCancel: AlpacaTradeCancelStream;
+    orderImbalance: AlpacaOrderImbalanceStream;
+    data: AlpacaStockStreamMessage;
+    subscription: {
+        trades: string[];
+        quotes: string[];
+        bars: string[];
+    };
+    authenticated: void;
+    connected: void;
+    disconnected: {
+        code: number;
+        reason: string;
+    };
+    stateChange: StreamState;
+    error: Error;
+}
+/**
+ * Stock Data Stream class for receiving real-time stock market data
+ * Uses the official Alpaca SDK data_stream_v2 for WebSocket management.
+ */
+export declare class StockDataStream extends EventEmitter {
+    private client;
+    private socket;
+    private state;
+    private feed;
+    private config;
+    private subscriptions;
+    private pendingSubscriptions;
+    constructor(client: AlpacaClient, config?: Partial<StockStreamConfig>);
+    /**
+     * Log helper
+     */
+    private log;
+    /**
+     * Get the current stream state
+     */
+    getState(): StreamState;
+    /**
+     * Check if stream is connected and authenticated
+     */
+    isStreamConnected(): boolean;
+    /**
+     * Get current subscriptions
+     */
+    getSubscriptions(): SubscriptionRequest;
+    /**
+     * Set the data feed
+     */
+    setFeed(feed: StockDataFeed): void;
+    /**
+     * Get the current data feed
+     */
+    getFeed(): StockDataFeed;
+    /**
+     * Connect to the stock data stream using SDK
+     */
+    connect(): Promise<void>;
+    /**
+     * Set up all data event handlers for SDK
+     */
+    private setupDataHandlers;
+    /**
+     * Disconnect from the stock data stream
+     */
+    disconnect(): void;
+    /**
+     * Subscribe to market data
+     */
+    subscribe(request: SubscriptionRequest): void;
+    /**
+     * Unsubscribe from market data
+     */
+    unsubscribe(request: SubscriptionRequest): void;
+    /**
+     * Subscribe to stock trades
+     */
+    subscribeTrades(symbols: string[]): void;
+    /**
+     * Subscribe to stock quotes
+     */
+    subscribeQuotes(symbols: string[]): void;
+    /**
+     * Subscribe to stock bars
+     */
+    subscribeBars(symbols: string[]): void;
+    /**
+     * Subscribe to all data types for symbols
+     */
+    subscribeAll(symbols: string[]): void;
+    /**
+     * Unsubscribe from stock trades
+     */
+    unsubscribeTrades(symbols: string[]): void;
+    /**
+     * Unsubscribe from stock quotes
+     */
+    unsubscribeQuotes(symbols: string[]): void;
+    /**
+     * Unsubscribe from stock bars
+     */
+    unsubscribeBars(symbols: string[]): void;
+    /**
+     * Unsubscribe from all data types for symbols
+     */
+    unsubscribeAll(symbols: string[]): void;
+    /**
+     * Send subscription request using SDK methods
+     */
+    private sendSubscription;
+    /**
+     * Send unsubscription request using SDK methods
+     */
+    private sendUnsubscription;
+    private convertTrade;
+    private convertQuote;
+    private convertBar;
+    private convertDailyBar;
+    private convertUpdatedBar;
+    private convertStatus;
+    private convertLuld;
+    private convertCancelError;
+    private convertCorrection;
+    /**
+     * Type-safe event listener registration
+     */
+    on<K extends keyof StockStreamEventMap>(event: K, listener: (data: StockStreamEventMap[K]) => void): this;
+    /**
+     * Type-safe event emitter
+     */
+    emit<K extends keyof StockStreamEventMap>(event: K, data?: StockStreamEventMap[K]): boolean;
+}
+/**
+ * Create a stock data stream for a client
+ */
+export declare function createStockDataStream(client: AlpacaClient, config?: Partial<StockStreamConfig>): StockDataStream;
+export default StockDataStream;
+//# sourceMappingURL=stock-stream.d.ts.map

package/dist/types/alpaca/streams/stock-stream.d.ts.map

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

package/dist/types/alpaca/streams/stream-manager.d.ts

@@ -0,0 +1,277 @@
+/**
+ * Stream Manager Module
+ * Unified management of all Alpaca WebSocket streams with connection pooling and coordination.
+ *
+ * Features:
+ * - Centralized stream lifecycle management
+ * - Connection pooling and reuse
+ * - Automatic reconnection handling
+ * - Coordinated subscriptions across streams
+ * - Health monitoring and status reporting
+ * - Graceful shutdown
+ *
+ * @example
+ * ```typescript
+ * const client = createAlpacaClient(config);
+ * const manager = createStreamManager(client);
+ *
+ * // Connect to specific streams
+ * await manager.connectTrading();
+ * await manager.connectStockData();
+ *
+ * // Or connect to all streams at once
+ * await manager.connectAll();
+ *
+ * // Get status
+ * const status = manager.getStatus();
+ * console.log(status); // { trading: true, stock: true, option: false, crypto: false }
+ *
+ * // Use individual streams
+ * const tradingStream = manager.getTradingStream();
+ * tradingStream?.on('fill', (update) => console.log('Order filled!'));
+ *
+ * // Graceful shutdown
+ * await manager.disconnectAll();
+ * ```
+ */
+import { AlpacaClient } from '../client';
+import { EventEmitter } from 'events';
+import { TradingStream } from './trading-stream';
+import { StockDataStream, StockStreamConfig } from './stock-stream';
+import { OptionDataStream, OptionStreamConfig } from './option-stream';
+import { CryptoDataStream, CryptoStreamConfig } from './crypto-stream';
+import { StreamConfig, StreamState, SubscriptionRequest } from './base-stream';
+/**
+ * Stream connection status for all managed streams
+ */
+export interface StreamStatus {
+    /** Trading stream connected status */
+    trading: boolean;
+    /** Stock data stream connected status */
+    stock: boolean;
+    /** Option data stream connected status */
+    option: boolean;
+    /** Crypto data stream connected status */
+    crypto: boolean;
+}
+/**
+ * Detailed stream status with state information
+ */
+export interface DetailedStreamStatus {
+    trading: {
+        connected: boolean;
+        state: StreamState;
+    };
+    stock: {
+        connected: boolean;
+        state: StreamState;
+    };
+    option: {
+        connected: boolean;
+        state: StreamState;
+    };
+    crypto: {
+        connected: boolean;
+        state: StreamState;
+    };
+}
+/**
+ * Stream manager configuration
+ */
+export interface StreamManagerConfig {
+    /** Base stream configuration */
+    baseConfig: Partial<StreamConfig>;
+    /** Stock stream specific configuration */
+    stockConfig: Partial<StockStreamConfig>;
+    /** Option stream specific configuration */
+    optionConfig: Partial<OptionStreamConfig>;
+    /** Crypto stream specific configuration */
+    cryptoConfig: Partial<CryptoStreamConfig>;
+    /** Auto-connect streams on creation */
+    autoConnect: boolean;
+    /** Enable health monitoring */
+    healthMonitoring: boolean;
+    /** Health check interval in milliseconds */
+    healthCheckInterval: number;
+}
+/**
+ * Default stream manager configuration
+ */
+export declare const DEFAULT_STREAM_MANAGER_CONFIG: StreamManagerConfig;
+/**
+ * Stream manager event map
+ */
+export interface StreamManagerEventMap {
+    'stream:connected': {
+        stream: 'trading' | 'stock' | 'option' | 'crypto';
+    };
+    'stream:disconnected': {
+        stream: 'trading' | 'stock' | 'option' | 'crypto';
+        code: number;
+        reason: string;
+    };
+    'stream:error': {
+        stream: 'trading' | 'stock' | 'option' | 'crypto';
+        error: Error;
+    };
+    'all:connected': void;
+    'all:disconnected': void;
+    'health:check': StreamStatus;
+}
+/**
+ * Unified Stream Manager
+ * Manages all WebSocket connections for a client with connection pooling and coordination.
+ */
+export declare class StreamManager extends EventEmitter {
+    private client;
+    private config;
+    private tradingStream;
+    private stockStream;
+    private optionStream;
+    private cryptoStream;
+    private healthCheckTimer;
+    private isShuttingDown;
+    constructor(client: AlpacaClient, config?: Partial<StreamManagerConfig>);
+    /**
+     * Connect to the trading stream
+     * @returns The connected trading stream
+     */
+    connectTrading(): Promise<TradingStream>;
+    /**
+     * Connect to the stock data stream
+     * @returns The connected stock data stream
+     */
+    connectStockData(): Promise<StockDataStream>;
+    /**
+     * Connect to the options data stream
+     * @returns The connected option data stream
+     */
+    connectOptionData(): Promise<OptionDataStream>;
+    /**
+     * Connect to the crypto data stream
+     * @returns The connected crypto data stream
+     */
+    connectCryptoData(): Promise<CryptoDataStream>;
+    /**
+     * Connect all streams concurrently
+     */
+    connectAll(): Promise<void>;
+    /**
+     * Connect only market data streams (stock, option, crypto)
+     */
+    connectMarketData(): Promise<void>;
+    /**
+     * Disconnect from the trading stream
+     */
+    disconnectTrading(): void;
+    /**
+     * Disconnect from the stock data stream
+     */
+    disconnectStockData(): void;
+    /**
+     * Disconnect from the option data stream
+     */
+    disconnectOptionData(): void;
+    /**
+     * Disconnect from the crypto data stream
+     */
+    disconnectCryptoData(): void;
+    /**
+     * Disconnect all streams
+     */
+    disconnectAll(): void;
+    /**
+     * Graceful shutdown - disconnect all streams and cleanup
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Get simple connection status
+     */
+    getStatus(): StreamStatus;
+    /**
+     * Get detailed connection status with state information
+     */
+    getDetailedStatus(): DetailedStreamStatus;
+    /**
+     * Check if any stream is connected
+     */
+    isAnyConnected(): boolean;
+    /**
+     * Check if all streams are connected
+     */
+    isAllConnected(): boolean;
+    /**
+     * Get the trading stream (may be null if not connected)
+     */
+    getTradingStream(): TradingStream | null;
+    /**
+     * Get the stock data stream (may be null if not connected)
+     */
+    getStockStream(): StockDataStream | null;
+    /**
+     * Get the option data stream (may be null if not connected)
+     */
+    getOptionStream(): OptionDataStream | null;
+    /**
+     * Get the crypto data stream (may be null if not connected)
+     */
+    getCryptoStream(): CryptoDataStream | null;
+    /**
+     * Subscribe to stock market data
+     */
+    subscribeStocks(request: SubscriptionRequest): void;
+    /**
+     * Subscribe to option market data
+     */
+    subscribeOptions(request: SubscriptionRequest): void;
+    /**
+     * Subscribe to crypto market data
+     */
+    subscribeCrypto(request: SubscriptionRequest): void;
+    /**
+     * Unsubscribe from stock market data
+     */
+    unsubscribeStocks(request: SubscriptionRequest): void;
+    /**
+     * Unsubscribe from option market data
+     */
+    unsubscribeOptions(request: SubscriptionRequest): void;
+    /**
+     * Unsubscribe from crypto market data
+     */
+    unsubscribeCrypto(request: SubscriptionRequest): void;
+    /**
+     * Get all current subscriptions
+     */
+    getAllSubscriptions(): {
+        stock: SubscriptionRequest;
+        option: SubscriptionRequest;
+        crypto: SubscriptionRequest;
+    };
+    /**
+     * Setup event handlers for a stream
+     */
+    private setupStreamEventHandlers;
+    /**
+     * Start health monitoring
+     */
+    private startHealthMonitoring;
+    /**
+     * Stop health monitoring
+     */
+    private stopHealthMonitoring;
+    /**
+     * Type-safe event listener registration
+     */
+    on<K extends keyof StreamManagerEventMap>(event: K, listener: (data: StreamManagerEventMap[K]) => void): this;
+    /**
+     * Type-safe event emitter
+     */
+    emit<K extends keyof StreamManagerEventMap>(event: K, data?: StreamManagerEventMap[K]): boolean;
+}
+/**
+ * Create a stream manager for a client
+ */
+export declare function createStreamManager(client: AlpacaClient, config?: Partial<StreamManagerConfig>): StreamManager;
+export default StreamManager;
+//# sourceMappingURL=stream-manager.d.ts.map

package/dist/types/alpaca/streams/stream-manager.d.ts.map

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