@adaptic/utils 0.0.382 → 0.0.900

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

@@ -0,0 +1,143 @@
+/**
+ * Base Stream Module
+ * Abstract base class for all Alpaca WebSocket streams
+ */
+import { EventEmitter } from "events";
+import WebSocket from "ws";
+import { LogOptions } from "../../types/logging-types";
+import { AlpacaClient } from "../client";
+/**
+ * Stream connection state
+ */
+export type StreamState = "disconnected" | "connecting" | "connected" | "authenticated" | "error";
+/**
+ * Stream configuration options
+ */
+export interface StreamConfig {
+    /** Auto-reconnect on disconnect */
+    autoReconnect: boolean;
+    /** Reconnect delay in milliseconds */
+    reconnectDelay: number;
+    /** Maximum reconnection attempts (0 = unlimited) */
+    maxReconnectAttempts: number;
+    /** Connection timeout in milliseconds */
+    connectionTimeout: number;
+    /** Authentication timeout in milliseconds */
+    authTimeout: number;
+    /** Heartbeat interval in milliseconds (0 = disabled) */
+    heartbeatInterval: number;
+}
+/**
+ * Default stream configuration
+ */
+export declare const DEFAULT_STREAM_CONFIG: StreamConfig;
+/**
+ * Subscription request structure
+ */
+export interface SubscriptionRequest {
+    trades?: string[];
+    quotes?: string[];
+    bars?: string[];
+}
+/**
+ * Abstract base class for all Alpaca WebSocket streams
+ */
+export declare abstract class BaseStream extends EventEmitter {
+    protected client: AlpacaClient;
+    protected ws: WebSocket | null;
+    protected state: StreamState;
+    protected config: StreamConfig;
+    protected reconnectAttempts: number;
+    protected reconnectTimer: NodeJS.Timeout | null;
+    protected heartbeatTimer: NodeJS.Timeout | null;
+    protected connectionTimer: NodeJS.Timeout | null;
+    protected subscriptions: SubscriptionRequest;
+    protected pendingSubscriptions: SubscriptionRequest | null;
+    /** Name of the stream for logging */
+    protected abstract readonly streamName: string;
+    /** WebSocket URL for the stream */
+    protected abstract getStreamUrl(): string;
+    constructor(client: AlpacaClient, config?: Partial<StreamConfig>);
+    /**
+     * Log a message with stream context
+     */
+    protected log(message: string, options?: LogOptions): void;
+    /**
+     * Get the current stream state
+     */
+    getState(): StreamState;
+    /**
+     * Check if stream is connected and authenticated
+     */
+    isStreamConnected(): boolean;
+    /**
+     * Get current subscriptions
+     */
+    getSubscriptions(): SubscriptionRequest;
+    /**
+     * Connect to the WebSocket stream
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the WebSocket stream
+     */
+    disconnect(): void;
+    /**
+     * Subscribe to market data
+     */
+    subscribe(request: SubscriptionRequest): void;
+    /**
+     * Unsubscribe from market data
+     */
+    unsubscribe(request: SubscriptionRequest): void;
+    /**
+     * Authenticate with the WebSocket
+     */
+    protected authenticate(): Promise<void>;
+    /**
+     * Send subscription request
+     */
+    protected sendSubscription(): void;
+    /**
+     * Send unsubscription request
+     */
+    protected sendUnsubscription(request: SubscriptionRequest): void;
+    /**
+     * Handle incoming WebSocket messages
+     */
+    protected handleMessage(data: WebSocket.Data): void;
+    /**
+     * Process a single message - to be implemented by subclasses
+     */
+    protected abstract processMessage(message: Record<string, unknown>): void;
+    /**
+     * Handle WebSocket close event
+     */
+    protected handleClose(code: number, reason: string): void;
+    /**
+     * Handle WebSocket error event
+     */
+    protected handleError(error: Error): void;
+    /**
+     * Schedule a reconnection attempt
+     */
+    protected scheduleReconnect(): void;
+    /**
+     * Start heartbeat to keep connection alive
+     */
+    protected startHeartbeat(): void;
+    /**
+     * Stop heartbeat timer
+     */
+    protected stopHeartbeat(): void;
+    /**
+     * Clear connection timer
+     */
+    protected clearConnectionTimer(): void;
+    /**
+     * Clear all timers
+     */
+    protected clearAllTimers(): void;
+}
+export default BaseStream;
+//# sourceMappingURL=base-stream.d.ts.map

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

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

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

@@ -0,0 +1,173 @@
+/**
+ * Crypto Data Stream Module
+ * Real-time cryptocurrency quotes, trades, and bars via Alpaca WebSocket (24/7)
+ *
+ * Uses the official Alpaca SDK crypto_stream_v1beta3 for reliable real-time data.
+ * Provides automatic reconnection, subscription management, and type-safe events.
+ */
+import { EventEmitter } from "events";
+import { AlpacaClient } from "../client";
+import { AlpacaCryptoTradeStream, AlpacaCryptoQuoteStream, AlpacaCryptoBarStream, AlpacaCryptoDailyBarStream, AlpacaCryptoUpdatedBarStream, AlpacaCryptoStreamMessage } from "../../types/alpaca-types";
+import { StreamConfig, StreamState, SubscriptionRequest } from "./base-stream";
+/**
+ * Crypto stream location
+ */
+export type CryptoStreamLocation = "us";
+/**
+ * Crypto stream configuration
+ */
+export interface CryptoStreamConfig extends StreamConfig {
+    /** Location for crypto data */
+    location: CryptoStreamLocation;
+}
+/**
+ * Default crypto stream configuration
+ */
+export declare const DEFAULT_CRYPTO_STREAM_CONFIG: Partial<CryptoStreamConfig>;
+/**
+ * Crypto stream event map for type-safe event handling
+ */
+export interface CryptoStreamEventMap {
+    trade: AlpacaCryptoTradeStream;
+    quote: AlpacaCryptoQuoteStream;
+    bar: AlpacaCryptoBarStream;
+    dailyBar: AlpacaCryptoDailyBarStream;
+    updatedBar: AlpacaCryptoUpdatedBarStream;
+    data: AlpacaCryptoStreamMessage;
+    subscription: {
+        trades: string[];
+        quotes: string[];
+        bars: string[];
+    };
+    authenticated: void;
+    connected: void;
+    disconnected: {
+        code: number;
+        reason: string;
+    };
+    stateChange: StreamState;
+    error: Error;
+}
+/**
+ * Crypto Data Stream class for receiving real-time cryptocurrency market data
+ * Uses the official Alpaca SDK crypto_stream_v1beta3 for WebSocket management.
+ * Operates 24/7 for cryptocurrency markets.
+ */
+export declare class CryptoDataStream extends EventEmitter {
+    private client;
+    private socket;
+    private state;
+    private location;
+    private config;
+    private subscriptions;
+    private pendingSubscriptions;
+    private currentSymbol;
+    constructor(client: AlpacaClient, config?: Partial<CryptoStreamConfig>);
+    /**
+     * 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 stream location
+     */
+    setLocation(location: CryptoStreamLocation): void;
+    /**
+     * Get the current stream location
+     */
+    getLocation(): CryptoStreamLocation;
+    /**
+     * Connect to the crypto data stream using SDK
+     */
+    connect(): Promise<void>;
+    /**
+     * Set up all data event handlers for SDK
+     */
+    private setupDataHandlers;
+    /**
+     * Disconnect from the crypto data stream
+     */
+    disconnect(): void;
+    /**
+     * Subscribe to market data
+     */
+    subscribe(request: SubscriptionRequest): void;
+    /**
+     * Unsubscribe from market data
+     */
+    unsubscribe(request: SubscriptionRequest): void;
+    /**
+     * Subscribe to crypto trades
+     */
+    subscribeTrades(symbols: string[]): void;
+    /**
+     * Subscribe to crypto quotes
+     */
+    subscribeQuotes(symbols: string[]): void;
+    /**
+     * Subscribe to crypto bars
+     */
+    subscribeBars(symbols: string[]): void;
+    /**
+     * Subscribe to all data types for crypto symbols
+     */
+    subscribeAll(symbols: string[]): void;
+    /**
+     * Unsubscribe from crypto trades
+     */
+    unsubscribeTrades(symbols: string[]): void;
+    /**
+     * Unsubscribe from crypto quotes
+     */
+    unsubscribeQuotes(symbols: string[]): void;
+    /**
+     * Unsubscribe from crypto bars
+     */
+    unsubscribeBars(symbols: string[]): void;
+    /**
+     * Unsubscribe from all data types for crypto symbols
+     */
+    unsubscribeAll(symbols: string[]): void;
+    /**
+     * Subscribe to popular crypto pairs
+     */
+    subscribePopularPairs(): 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;
+    /**
+     * Type-safe event listener registration
+     */
+    on<K extends keyof CryptoStreamEventMap>(event: K, listener: (data: CryptoStreamEventMap[K]) => void): this;
+    /**
+     * Type-safe event emitter
+     */
+    emit<K extends keyof CryptoStreamEventMap>(event: K, data?: CryptoStreamEventMap[K]): boolean;
+}
+/**
+ * Create a crypto data stream for a client
+ */
+export declare function createCryptoDataStream(client: AlpacaClient, config?: Partial<CryptoStreamConfig>): CryptoDataStream;
+export default CryptoDataStream;
+//# sourceMappingURL=crypto-stream.d.ts.map

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

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

package/dist/types/alpaca/streams/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Streams Module Index
+ * Re-exports all stream-related functionality for Alpaca WebSocket connections.
+ *
+ * This module provides unified WebSocket streaming for:
+ * - Trading updates (order fills, cancellations, etc.)
+ * - Stock market data (trades, quotes, bars)
+ * - Options market data (trades, quotes, bars)
+ * - Crypto market data (trades, quotes, bars)
+ *
+ * @example
+ * ```typescript
+ * import { createStreamManager, createAlpacaClient } from '@adaptic/utils';
+ *
+ * const client = createAlpacaClient({
+ *   apiKey: 'your-api-key',
+ *   apiSecret: 'your-api-secret',
+ *   accountType: 'PAPER',
+ * });
+ *
+ * // Use the unified stream manager
+ * const manager = createStreamManager(client);
+ * await manager.connectAll();
+ *
+ * // Subscribe to stock data
+ * manager.subscribeStocks({
+ *   trades: ['AAPL', 'MSFT'],
+ *   quotes: ['AAPL', 'MSFT'],
+ * });
+ *
+ * // Listen for trading updates
+ * const tradingStream = manager.getTradingStream();
+ * tradingStream?.on('fill', (update) => {
+ *   console.log(`Order filled: ${update.order.symbol}`);
+ * });
+ *
+ * // Or use individual streams directly
+ * import { createStockDataStream, createTradingStream } from '@adaptic/utils';
+ *
+ * const stockStream = createStockDataStream(client);
+ * await stockStream.connect();
+ * stockStream.subscribeTrades(['AAPL', 'TSLA']);
+ * stockStream.on('trade', (trade) => {
+ *   console.log(`Trade: ${trade.S} @ ${trade.p}`);
+ * });
+ * ```
+ */
+export { BaseStream, StreamConfig, StreamState, SubscriptionRequest, DEFAULT_STREAM_CONFIG, } from "./base-stream";
+export { TradingStream, TradingStreamEvent, TradingStreamEventMap, createTradingStream, } from "./trading-stream";
+export { StockDataStream, StockDataFeed, StockStreamConfig, StockStreamEventMap, createStockDataStream, DEFAULT_STOCK_STREAM_CONFIG, } from "./stock-stream";
+export { OptionDataStream, OptionDataFeed, OptionStreamConfig, OptionStreamEventMap, createOptionDataStream, DEFAULT_OPTION_STREAM_CONFIG, } from "./option-stream";
+export { CryptoDataStream, CryptoStreamLocation, CryptoStreamConfig, CryptoStreamEventMap, createCryptoDataStream, DEFAULT_CRYPTO_STREAM_CONFIG, } from "./crypto-stream";
+export { StreamManager, StreamStatus, DetailedStreamStatus, StreamManagerConfig, StreamManagerEventMap, createStreamManager, DEFAULT_STREAM_MANAGER_CONFIG, } from "./stream-manager";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/alpaca/streams/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/alpaca/streams/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAGH,OAAO,EACL,UAAU,EACV,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,kBAAkB,CAAC"}

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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"}