@adaptic/utils 0.0.382 → 0.1.0

package/dist/types/alpaca/options/strategies.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Options Strategies Module
+ * Build and execute common option strategies using Alpaca SDK
+ */
+import { AlpacaClient } from '../client';
+import { AlpacaOrder, TimeInForce } from '../../types/alpaca-types';
+/**
+ * Error class for option strategy operations
+ */
+export declare class OptionStrategyError extends Error {
+    code: string;
+    strategy?: string | undefined;
+    details?: unknown | undefined;
+    constructor(message: string, code: string, strategy?: string | undefined, details?: unknown | undefined);
+}
+/**
+ * Parameters for creating a vertical spread (call or put spread)
+ */
+export interface VerticalSpreadParams {
+    /** Underlying stock symbol */
+    underlying: string;
+    /** Expiration date in YYYY-MM-DD format */
+    expirationDate: string;
+    /** Option type: call or put */
+    type: 'call' | 'put';
+    /** Strike price for the long leg */
+    longStrike: number;
+    /** Strike price for the short leg */
+    shortStrike: number;
+    /** Number of contracts */
+    qty: number;
+    /** Debit = buy spread, Credit = sell spread */
+    direction: 'debit' | 'credit';
+    /** Optional limit price for the spread (net debit or credit) */
+    limitPrice?: number;
+    /** Time in force for the order */
+    timeInForce?: TimeInForce;
+}
+/**
+ * Parameters for creating an iron condor
+ */
+export interface IronCondorParams {
+    /** Underlying stock symbol */
+    underlying: string;
+    /** Expiration date in YYYY-MM-DD format */
+    expirationDate: string;
+    /** Strike price for the long put (lowest strike) */
+    putLongStrike: number;
+    /** Strike price for the short put */
+    putShortStrike: number;
+    /** Strike price for the short call */
+    callShortStrike: number;
+    /** Strike price for the long call (highest strike) */
+    callLongStrike: number;
+    /** Number of contracts */
+    qty: number;
+    /** Optional limit price for the spread (net credit) */
+    limitPrice?: number;
+    /** Time in force for the order */
+    timeInForce?: TimeInForce;
+}
+/**
+ * Parameters for creating a straddle
+ */
+export interface StraddleParams {
+    /** Underlying stock symbol */
+    underlying: string;
+    /** Expiration date in YYYY-MM-DD format */
+    expirationDate: string;
+    /** Strike price (same for both call and put) */
+    strike: number;
+    /** Number of contracts */
+    qty: number;
+    /** Long = buy both options, Short = sell both options */
+    direction: 'long' | 'short';
+    /** Optional limit price for the spread */
+    limitPrice?: number;
+    /** Time in force for the order */
+    timeInForce?: TimeInForce;
+}
+/**
+ * Parameters for creating a covered call
+ */
+export interface CoveredCallParams {
+    /** Underlying stock symbol */
+    underlying: string;
+    /** Expiration date in YYYY-MM-DD format */
+    expirationDate: string;
+    /** Strike price for the call option */
+    strike: number;
+    /** Number of contracts (each contract = 100 shares) */
+    qty: number;
+    /** Optional limit price for the call option */
+    limitPrice?: number;
+    /** Time in force for the order */
+    timeInForce?: TimeInForce;
+}
+/**
+ * Parameters for rolling an option position
+ */
+export interface RollPositionParams {
+    /** Current option contract symbol to close */
+    currentSymbol: string;
+    /** New expiration date in YYYY-MM-DD format */
+    newExpirationDate: string;
+    /** New strike price */
+    newStrike: number;
+    /** Option type: call or put */
+    type: 'call' | 'put';
+    /** Optional limit price for the roll (net debit or credit) */
+    limitPrice?: number;
+    /** Time in force for the order */
+    timeInForce?: TimeInForce;
+}
+/**
+ * Parameters for creating a strangle
+ */
+export interface StrangleParams {
+    /** Underlying stock symbol */
+    underlying: string;
+    /** Expiration date in YYYY-MM-DD format */
+    expirationDate: string;
+    /** Strike price for the put option (lower strike) */
+    putStrike: number;
+    /** Strike price for the call option (higher strike) */
+    callStrike: number;
+    /** Number of contracts */
+    qty: number;
+    /** Long = buy both options, Short = sell both options */
+    direction: 'long' | 'short';
+    /** Optional limit price for the spread */
+    limitPrice?: number;
+    /** Time in force for the order */
+    timeInForce?: TimeInForce;
+}
+/**
+ * Parameters for creating a butterfly spread
+ */
+export interface ButterflySpreadParams {
+    /** Underlying stock symbol */
+    underlying: string;
+    /** Expiration date in YYYY-MM-DD format */
+    expirationDate: string;
+    /** Option type: call or put */
+    type: 'call' | 'put';
+    /** Lower strike price */
+    lowerStrike: number;
+    /** Middle strike price (usually ATM) */
+    middleStrike: number;
+    /** Upper strike price */
+    upperStrike: number;
+    /** Number of contracts */
+    qty: number;
+    /** Optional limit price for the spread */
+    limitPrice?: number;
+    /** Time in force for the order */
+    timeInForce?: TimeInForce;
+}
+/**
+ * Build an OCC-compliant option symbol
+ * Format: ROOT + YYMMDD + C/P + Strike (8 digits with 3 decimals)
+ */
+export declare function buildOptionSymbol(underlying: string, expirationDate: string, type: 'call' | 'put', strike: number): string;
+/**
+ * Create a vertical spread (call or put spread)
+ * - Bull Call Spread: Buy lower strike call, sell higher strike call
+ * - Bear Call Spread: Sell lower strike call, buy higher strike call
+ * - Bull Put Spread: Sell higher strike put, buy lower strike put
+ * - Bear Put Spread: Buy higher strike put, sell lower strike put
+ */
+export declare function createVerticalSpread(client: AlpacaClient, params: VerticalSpreadParams): Promise<AlpacaOrder>;
+/**
+ * Create an iron condor
+ * Combines a bull put spread and a bear call spread
+ * - Buy put at putLongStrike (lowest)
+ * - Sell put at putShortStrike
+ * - Sell call at callShortStrike
+ * - Buy call at callLongStrike (highest)
+ */
+export declare function createIronCondor(client: AlpacaClient, params: IronCondorParams): Promise<AlpacaOrder>;
+/**
+ * Create a straddle (buy/sell both call and put at same strike)
+ * - Long straddle: Buy call and put at same strike (expects high volatility)
+ * - Short straddle: Sell call and put at same strike (expects low volatility)
+ */
+export declare function createStraddle(client: AlpacaClient, params: StraddleParams): Promise<AlpacaOrder>;
+/**
+ * Create a covered call
+ * - Buy (or already own) 100 shares per contract
+ * - Sell call option against the shares
+ */
+export declare function createCoveredCall(client: AlpacaClient, params: CoveredCallParams): Promise<{
+    stockOrder: AlpacaOrder;
+    optionOrder: AlpacaOrder;
+}>;
+/**
+ * Roll an option position to a new expiration/strike
+ * Closes the current position and opens a new one
+ */
+export declare function rollOptionPosition(client: AlpacaClient, params: RollPositionParams): Promise<AlpacaOrder>;
+/**
+ * Create a strangle (buy/sell call and put at different strikes)
+ * - Long strangle: Buy OTM call and OTM put (expects high volatility)
+ * - Short strangle: Sell OTM call and OTM put (expects low volatility)
+ */
+export declare function createStrangle(client: AlpacaClient, params: StrangleParams): Promise<AlpacaOrder>;
+/**
+ * Create a butterfly spread
+ * - Long butterfly: Buy 1 lower, sell 2 middle, buy 1 upper
+ * - Expects price to stay near middle strike
+ */
+export declare function createButterflySpread(client: AlpacaClient, params: ButterflySpreadParams): Promise<AlpacaOrder>;
+declare const _default: {
+    buildOptionSymbol: typeof buildOptionSymbol;
+    createVerticalSpread: typeof createVerticalSpread;
+    createIronCondor: typeof createIronCondor;
+    createStraddle: typeof createStraddle;
+    createCoveredCall: typeof createCoveredCall;
+    rollOptionPosition: typeof rollOptionPosition;
+    createStrangle: typeof createStrangle;
+    createButterflySpread: typeof createButterflySpread;
+};
+export default _default;
+//# sourceMappingURL=strategies.d.ts.map

package/dist/types/alpaca/options/strategies.d.ts.map

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

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