@adaptic/utils 0.0.383 → 0.1.1

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

@@ -0,0 +1,186 @@
+/**
+ * Trading Stream Module
+ * WebSocket stream for real-time trading updates (order fills, cancellations, etc.)
+ *
+ * Features:
+ * - Real-time order status updates
+ * - Automatic reconnection with exponential backoff
+ * - Type-safe event handling
+ * - Comprehensive logging
+ *
+ * @example
+ * ```typescript
+ * const client = createAlpacaClient(config);
+ * const stream = createTradingStream(client);
+ *
+ * stream.on('fill', (update) => {
+ *   console.log(`Order filled: ${update.order.symbol} @ ${update.price}`);
+ * });
+ *
+ * stream.on('trade_update', (update) => {
+ *   console.log(`Trade update: ${update.event}`);
+ * });
+ *
+ * await stream.connect();
+ * ```
+ */
+import { AlpacaClient } from '../client';
+import { BaseStream, StreamConfig } from './base-stream';
+import { TradeUpdate } from '../../types/alpaca-types';
+/**
+ * Trading stream event names representing all possible order status changes.
+ * These events are emitted when order state changes occur.
+ */
+export type TradingStreamEvent = 'new' | 'fill' | 'partial_fill' | 'canceled' | 'expired' | 'done_for_day' | 'replaced' | 'rejected' | 'pending_new' | 'pending_cancel' | 'pending_replace' | 'calculated' | 'suspended' | 'order_cancel_rejected' | 'order_replace_rejected' | 'stopped' | 'accepted' | 'accepted_for_bidding';
+/**
+ * Trading stream event map for type-safe event handling.
+ * Maps event names to their payload types.
+ */
+export interface TradingStreamEventMap {
+    /** Generic trade update event - emitted for all order changes */
+    'trade_update': TradeUpdate;
+    /** Emitted when stream is authenticated */
+    'authenticated': void;
+    /** Emitted when stream is connected */
+    'connected': void;
+    /** Emitted when stream is disconnected */
+    'disconnected': {
+        code: number;
+        reason: string;
+    };
+    /** Emitted on stream errors */
+    'error': Error;
+    /** Emitted when max reconnection attempts reached */
+    'max_reconnects': void;
+    'new': TradeUpdate;
+    'fill': TradeUpdate;
+    'partial_fill': TradeUpdate;
+    'canceled': TradeUpdate;
+    'expired': TradeUpdate;
+    'done_for_day': TradeUpdate;
+    'replaced': TradeUpdate;
+    'rejected': TradeUpdate;
+    'pending_new': TradeUpdate;
+    'pending_cancel': TradeUpdate;
+    'pending_replace': TradeUpdate;
+    'calculated': TradeUpdate;
+    'suspended': TradeUpdate;
+    'order_cancel_rejected': TradeUpdate;
+    'order_replace_rejected': TradeUpdate;
+    'stopped': TradeUpdate;
+    'accepted': TradeUpdate;
+    'accepted_for_bidding': TradeUpdate;
+}
+/**
+ * Trading Stream class for receiving real-time order updates.
+ *
+ * Connects to Alpaca's trading WebSocket and provides real-time
+ * updates on order status changes including fills, cancellations,
+ * rejections, and more.
+ *
+ * @extends BaseStream
+ */
+export declare class TradingStream extends BaseStream {
+    protected readonly streamName = "TradingStream";
+    private tradeUpdateCallback;
+    private orderCallbacks;
+    constructor(client: AlpacaClient, config?: Partial<StreamConfig>);
+    /**
+     * Get the WebSocket URL for trading stream
+     */
+    protected getStreamUrl(): string;
+    /**
+     * Override authenticate to use trading stream format
+     */
+    protected authenticate(): Promise<void>;
+    /**
+     * Subscribe to trade updates after authentication
+     */
+    private subscribeToTradeUpdates;
+    /**
+     * Process incoming messages
+     */
+    protected processMessage(message: Record<string, unknown>): void;
+    /**
+     * Handle listening confirmation message
+     */
+    private handleListeningMessage;
+    /**
+     * Handle trade update message
+     */
+    private handleTradeUpdate;
+    /**
+     * Check if an event represents a terminal order state
+     */
+    private isTerminalState;
+    /**
+     * Register a callback for trade updates
+     * @param callback Function to call when trade updates are received
+     */
+    onTradeUpdate(callback: (update: TradeUpdate) => void): void;
+    /**
+     * Remove the trade update callback
+     */
+    removeTradeUpdateCallback(): void;
+    /**
+     * Register a callback for a specific order's updates.
+     * The callback is automatically removed when the order reaches a terminal state.
+     *
+     * @param orderId The order ID to watch
+     * @param callback Function to call when updates for this order are received
+     */
+    watchOrder(orderId: string, callback: (update: TradeUpdate) => void): void;
+    /**
+     * Stop watching a specific order
+     *
+     * @param orderId The order ID to stop watching
+     */
+    unwatchOrder(orderId: string): void;
+    /**
+     * Get all currently watched order IDs
+     */
+    getWatchedOrders(): string[];
+    /**
+     * Wait for an order to reach a terminal state.
+     * Returns a promise that resolves with the final trade update.
+     *
+     * @param orderId The order ID to wait for
+     * @param timeoutMs Optional timeout in milliseconds (default: 30000)
+     * @returns Promise resolving to the final TradeUpdate
+     * @throws Error if timeout is reached
+     *
+     * @example
+     * ```typescript
+     * const finalUpdate = await stream.waitForOrderCompletion(order.id, 60000);
+     * console.log(`Order ${finalUpdate.event}: ${finalUpdate.order.filled_qty} filled`);
+     * ```
+     */
+    waitForOrderCompletion(orderId: string, timeoutMs?: number): Promise<TradeUpdate>;
+    /**
+     * Schedule a reconnection attempt with exponential backoff.
+     * Emits 'max_reconnects' event when maximum attempts are reached.
+     */
+    protected scheduleReconnect(): void;
+    /**
+     * Type-safe event listener registration
+     */
+    on<K extends keyof TradingStreamEventMap>(event: K, listener: (data: TradingStreamEventMap[K]) => void): this;
+    /**
+     * Type-safe once event listener registration
+     */
+    once<K extends keyof TradingStreamEventMap>(event: K, listener: (data: TradingStreamEventMap[K]) => void): this;
+    /**
+     * Type-safe event emitter
+     */
+    emit<K extends keyof TradingStreamEventMap>(event: K, data?: TradingStreamEventMap[K]): boolean;
+    /**
+     * Type-safe remove listener
+     */
+    off<K extends keyof TradingStreamEventMap>(event: K, listener: (data: TradingStreamEventMap[K]) => void): this;
+}
+/**
+ * Create a trading stream for a client
+ */
+export declare function createTradingStream(client: AlpacaClient, config?: Partial<StreamConfig>): TradingStream;
+export default TradingStream;
+//# sourceMappingURL=trading-stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trading-stream.d.ts","sourceRoot":"","sources":["../../../../src/alpaca/streams/trading-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B,KAAK,GACL,MAAM,GACN,cAAc,GACd,UAAU,GACV,SAAS,GACT,cAAc,GACd,UAAU,GACV,UAAU,GACV,aAAa,GACb,gBAAgB,GAChB,iBAAiB,GACjB,YAAY,GACZ,WAAW,GACX,uBAAuB,GACvB,wBAAwB,GACxB,SAAS,GACT,UAAU,GACV,sBAAsB,CAAC;AAE3B;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,cAAc,EAAE,WAAW,CAAC;IAC5B,2CAA2C;IAC3C,eAAe,EAAE,IAAI,CAAC;IACtB,uCAAuC;IACvC,WAAW,EAAE,IAAI,CAAC;IAClB,0CAA0C;IAC1C,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,+BAA+B;IAC/B,OAAO,EAAE,KAAK,CAAC;IACf,qDAAqD;IACrD,gBAAgB,EAAE,IAAI,CAAC;IAEvB,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,cAAc,EAAE,WAAW,CAAC;IAC5B,UAAU,EAAE,WAAW,CAAC;IACxB,SAAS,EAAE,WAAW,CAAC;IACvB,cAAc,EAAE,WAAW,CAAC;IAC5B,UAAU,EAAE,WAAW,CAAC;IACxB,UAAU,EAAE,WAAW,CAAC;IACxB,aAAa,EAAE,WAAW,CAAC;IAC3B,gBAAgB,EAAE,WAAW,CAAC;IAC9B,iBAAiB,EAAE,WAAW,CAAC;IAC/B,YAAY,EAAE,WAAW,CAAC;IAC1B,WAAW,EAAE,WAAW,CAAC;IACzB,uBAAuB,EAAE,WAAW,CAAC;IACrC,wBAAwB,EAAE,WAAW,CAAC;IACtC,SAAS,EAAE,WAAW,CAAC;IACvB,UAAU,EAAE,WAAW,CAAC;IACxB,sBAAsB,EAAE,WAAW,CAAC;CACrC;AAED;;;;;;;;GAQG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,SAAS,CAAC,QAAQ,CAAC,UAAU,mBAAmB;IAChD,OAAO,CAAC,mBAAmB,CAAgD;IAC3E,OAAO,CAAC,cAAc,CAAyD;gBAEnE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAIpE;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,MAAM;IAOhC;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA6CvC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAiB/B;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAsBhE;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8BzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAI5D;;OAEG;IACH,yBAAyB,IAAI,IAAI;IAIjC;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAK1E;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKnC;;OAEG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;;;;;;;;;;;;;OAcG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAgBxF;;;OAGG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;IAyBnC;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,qBAAqB,EACtC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,IAAI,GACjD,IAAI;IAIP;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,qBAAqB,EACxC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,IAAI,GACjD,IAAI;IAIP;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,qBAAqB,EACxC,KAAK,EAAE,CAAC,EACR,IAAI,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC9B,OAAO;IAIV;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,qBAAqB,EACvC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,IAAI,GACjD,IAAI;CAGR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM,GACjC,aAAa,CAEf;AAED,eAAe,aAAa,CAAC"}

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

@@ -0,0 +1,88 @@
+/**
+ * Alpaca WebSocket Streams Module
+ * Real-time market data and trade update streams
+ *
+ * NOTE: This is a placeholder module. Full streaming support requires
+ * additional implementation for WebSocket connection management.
+ *
+ * @module @adaptic/utils/alpaca/streams
+ */
+import { AlpacaClient } from './client';
+/**
+ * Stream manager interface for managing WebSocket connections
+ */
+export interface StreamManager {
+    /** Connect to trading updates stream */
+    connectTradingStream: () => Promise<void>;
+    /** Connect to market data stream */
+    connectDataStream: () => Promise<void>;
+    /** Disconnect all streams */
+    disconnect: () => void;
+    /** Subscribe to trade updates for specific symbols */
+    subscribeToTrades: (symbols: string[]) => void;
+    /** Subscribe to quote updates for specific symbols */
+    subscribeToQuotes: (symbols: string[]) => void;
+    /** Subscribe to bar updates for specific symbols */
+    subscribeToBars: (symbols: string[]) => void;
+    /** Unsubscribe from symbols */
+    unsubscribe: (symbols: string[]) => void;
+}
+/**
+ * Stream event types
+ */
+export type StreamEventType = 'trade' | 'quote' | 'bar' | 'trade_update' | 'error' | 'connected' | 'disconnected';
+/**
+ * Stream event handler
+ */
+export type StreamEventHandler<T = unknown> = (event: T) => void;
+/**
+ * Configuration for stream manager
+ */
+export interface StreamManagerConfig {
+    /** Client for authentication */
+    client: AlpacaClient;
+    /** Handler for trade events */
+    onTrade?: StreamEventHandler;
+    /** Handler for quote events */
+    onQuote?: StreamEventHandler;
+    /** Handler for bar events */
+    onBar?: StreamEventHandler;
+    /** Handler for trade update events (order fills, etc.) */
+    onTradeUpdate?: StreamEventHandler;
+    /** Handler for errors */
+    onError?: StreamEventHandler<Error>;
+    /** Handler for connection events */
+    onConnected?: StreamEventHandler<void>;
+    /** Handler for disconnection events */
+    onDisconnected?: StreamEventHandler<void>;
+}
+/**
+ * Create a stream manager for real-time data
+ *
+ * NOTE: This is a placeholder implementation. Full streaming support
+ * requires WebSocket connection management which is available through
+ * the Alpaca SDK's built-in streaming capabilities.
+ *
+ * @param config - Stream manager configuration
+ * @returns A stream manager instance
+ *
+ * @example
+ * ```typescript
+ * const client = createAlpacaClient({ ... });
+ * const streamManager = createStreamManager({
+ *   client,
+ *   onTrade: (trade) => console.log('Trade:', trade),
+ *   onQuote: (quote) => console.log('Quote:', quote),
+ *   onError: (error) => console.error('Stream error:', error),
+ * });
+ *
+ * await streamManager.connectDataStream();
+ * streamManager.subscribeToTrades(['AAPL', 'GOOGL']);
+ * ```
+ */
+export declare function createStreamManager(_config: StreamManagerConfig): StreamManager;
+declare const _default: {
+    createStreamManager: typeof createStreamManager;
+};
+export default _default;
+//# sourceMappingURL=streams.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../../../src/alpaca/streams.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,oBAAoB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,oCAAoC;IACpC,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,6BAA6B;IAC7B,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,sDAAsD;IACtD,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC/C,sDAAsD;IACtD,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC/C,oDAAoD;IACpD,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC7C,+BAA+B;IAC/B,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,cAAc,GAAG,OAAO,GAAG,WAAW,GAAG,cAAc,CAAC;AAElH;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,MAAM,EAAE,YAAY,CAAC;IACrB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,+BAA+B;IAC/B,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,6BAA6B;IAC7B,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,0DAA0D;IAC1D,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,yBAAyB;IACzB,OAAO,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACpC,oCAAoC;IACpC,WAAW,CAAC,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACvC,uCAAuC;IACvC,cAAc,CAAC,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa,CA0B/E;;;;AAED,wBAEE"}

package/dist/types/alpaca/test-imports.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Test imports file
+ * Verifies that all Alpaca module exports compile correctly
+ */
+declare const testTypes: () => Promise<void>;
+export { testTypes };
+//# sourceMappingURL=test-imports.d.ts.map

package/dist/types/alpaca/test-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-imports.d.ts","sourceRoot":"","sources":["../../../src/alpaca/test-imports.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqGH,QAAA,MAAM,SAAS,qBAuBd,CAAC;AAGF,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/types/alpaca/trading/account.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Account Management Module
+ * Handles account details, configuration, and portfolio history
+ */
+import { AlpacaClient } from '../client';
+import { AlpacaAccountDetails, AccountConfiguration, PortfolioHistoryParams, PortfolioHistoryResponse } from '../../types/alpaca-types';
+/**
+ * Trading eligibility status for an account
+ */
+export interface TradingEligibility {
+    canTrade: boolean;
+    reasons: string[];
+    buyingPower: number;
+    dayTradeCount: number;
+    isPatternDayTrader: boolean;
+}
+/**
+ * Buying power breakdown across different asset classes
+ */
+export interface BuyingPowerBreakdown {
+    cash: number;
+    equity: number;
+    dayTradingBuyingPower: number;
+    regtBuyingPower: number;
+    optionsBuyingPower: number;
+    cryptoBuyingPower: number;
+}
+/**
+ * Pattern Day Trader (PDT) status information
+ */
+export interface PDTStatus {
+    isPatternDayTrader: boolean;
+    dayTradeCount: number;
+    dayTradesRemaining: number;
+    canDayTrade: boolean;
+}
+/**
+ * Daily return information
+ */
+export interface DailyReturn {
+    date: Date;
+    equity: number;
+    profitLoss: number;
+    profitLossPct: number;
+    dailyReturn: number;
+}
+/**
+ * Period performance metrics
+ */
+export interface PeriodPerformance {
+    startDate: Date;
+    endDate: Date;
+    startingEquity: number;
+    endingEquity: number;
+    totalReturn: number;
+    totalReturnPct: number;
+    averageDailyReturn: number;
+    maxDrawdown: number;
+    maxDrawdownPct: number;
+    sharpeRatio: number | null;
+    volatility: number;
+    winningDays: number;
+    losingDays: number;
+    winRate: number;
+}
+/**
+ * Equity curve data point
+ */
+export interface EquityCurvePoint {
+    timestamp: Date;
+    equity: number;
+    profitLoss: number;
+    profitLossPct: number;
+    cumulativeReturn: number;
+}
+/**
+ * Get account details from Alpaca
+ * @param client - AlpacaClient instance
+ * @returns Promise resolving to account details
+ */
+export declare function getAccountDetails(client: AlpacaClient): Promise<AlpacaAccountDetails>;
+/**
+ * Get account configuration from Alpaca
+ * @param client - AlpacaClient instance
+ * @returns Promise resolving to account configuration
+ */
+export declare function getAccountConfiguration(client: AlpacaClient): Promise<AccountConfiguration>;
+/**
+ * Update account configuration on Alpaca
+ * @param client - AlpacaClient instance
+ * @param config - Partial configuration to update
+ * @returns Promise resolving to updated account configuration
+ */
+export declare function updateAccountConfiguration(client: AlpacaClient, config: Partial<AccountConfiguration>): Promise<AccountConfiguration>;
+/**
+ * Get portfolio history from Alpaca
+ * @param client - AlpacaClient instance
+ * @param params - Parameters for portfolio history request
+ * @returns Promise resolving to portfolio history response
+ */
+export declare function getPortfolioHistory(client: AlpacaClient, params: PortfolioHistoryParams): Promise<PortfolioHistoryResponse>;
+/**
+ * Check if account is eligible for trading
+ * @param client - AlpacaClient instance
+ * @returns Promise resolving to trading eligibility status
+ */
+export declare function checkTradingEligibility(client: AlpacaClient): Promise<TradingEligibility>;
+/**
+ * Get buying power breakdown for different asset classes
+ * @param client - AlpacaClient instance
+ * @returns Promise resolving to buying power breakdown
+ */
+export declare function getBuyingPower(client: AlpacaClient): Promise<BuyingPowerBreakdown>;
+/**
+ * Get options trading level for the account
+ * @param client - AlpacaClient instance
+ * @returns Promise resolving to options trading level (0-3)
+ */
+export declare function getOptionsTradingLevel(client: AlpacaClient): Promise<0 | 1 | 2 | 3>;
+/**
+ * Get Pattern Day Trader (PDT) status
+ * @param client - AlpacaClient instance
+ * @returns Promise resolving to PDT status
+ */
+export declare function getPDTStatus(client: AlpacaClient): Promise<PDTStatus>;
+/**
+ * Get daily returns from portfolio history
+ * @param client - AlpacaClient instance
+ * @param period - Period to fetch (e.g., '1W', '1M', '3M', '1A')
+ * @returns Promise resolving to array of daily returns
+ */
+export declare function getDailyReturns(client: AlpacaClient, period?: string): Promise<DailyReturn[]>;
+/**
+ * Calculate period performance metrics
+ * @param client - AlpacaClient instance
+ * @param period - Period to analyze (e.g., '1W', '1M', '3M', '1A')
+ * @returns Promise resolving to period performance metrics
+ */
+export declare function calculatePeriodPerformance(client: AlpacaClient, period?: string): Promise<PeriodPerformance>;
+/**
+ * Get equity curve data
+ * @param client - AlpacaClient instance
+ * @param params - Portfolio history parameters
+ * @returns Promise resolving to equity curve data points
+ */
+export declare function getEquityCurve(client: AlpacaClient, params?: PortfolioHistoryParams): Promise<EquityCurvePoint[]>;
+/**
+ * Get account equity and cash summary
+ * @param client - AlpacaClient instance
+ * @returns Promise resolving to account summary
+ */
+export declare function getAccountSummary(client: AlpacaClient): Promise<{
+    equity: number;
+    cash: number;
+    portfolioValue: number;
+    longMarketValue: number;
+    shortMarketValue: number;
+    lastEquity: number;
+    todayProfitLoss: number;
+    todayProfitLossPct: number;
+}>;
+/**
+ * Check if account is a margin account
+ * @param client - AlpacaClient instance
+ * @returns Promise resolving to boolean indicating margin status
+ */
+export declare function isMarginAccount(client: AlpacaClient): Promise<boolean>;
+/**
+ * Get margin information for the account
+ * @param client - AlpacaClient instance
+ * @returns Promise resolving to margin information
+ */
+export declare function getMarginInfo(client: AlpacaClient): Promise<{
+    multiplier: string;
+    initialMargin: number;
+    maintenanceMargin: number;
+    lastMaintenanceMargin: number;
+    sma: number;
+    marginCallAmount: number;
+}>;
+declare const _default: {
+    getAccountDetails: typeof getAccountDetails;
+    getAccountConfiguration: typeof getAccountConfiguration;
+    updateAccountConfiguration: typeof updateAccountConfiguration;
+    getPortfolioHistory: typeof getPortfolioHistory;
+    checkTradingEligibility: typeof checkTradingEligibility;
+    getBuyingPower: typeof getBuyingPower;
+    getOptionsTradingLevel: typeof getOptionsTradingLevel;
+    getPDTStatus: typeof getPDTStatus;
+    getDailyReturns: typeof getDailyReturns;
+    calculatePeriodPerformance: typeof calculatePeriodPerformance;
+    getEquityCurve: typeof getEquityCurve;
+    getAccountSummary: typeof getAccountSummary;
+    isMarginAccount: typeof isMarginAccount;
+    getMarginInfo: typeof getMarginInfo;
+};
+export default _default;
+//# sourceMappingURL=account.d.ts.map

package/dist/types/alpaca/trading/account.d.ts.map

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

package/dist/types/alpaca/trading/bracket-orders.d.ts

@@ -0,0 +1,162 @@
+import { AlpacaOrder, OrderSide, TimeInForce, CreateOrderParams } from '../../types/alpaca-types';
+/**
+ * Interface for the Alpaca client/API that can execute bracket orders.
+ * This can be implemented by AlpacaTradingAPI or a future AlpacaClient class.
+ */
+export interface BracketOrderExecutor {
+    /** Execute an order request and return the created order */
+    createOrder(params: CreateOrderParams): Promise<AlpacaOrder>;
+}
+/**
+ * Parameters for creating a bracket order.
+ */
+export interface BracketOrderParams {
+    /** Stock symbol */
+    symbol: string;
+    /** Number of shares */
+    qty: number;
+    /** Order side: buy or sell */
+    side: OrderSide;
+    /** Entry order type: market for immediate, limit for price-specific */
+    type: 'market' | 'limit';
+    /** Limit price for entry (required if type is 'limit') */
+    limitPrice?: number;
+    /** Take profit configuration */
+    takeProfit: {
+        /** Price at which to take profit */
+        limitPrice: number;
+    };
+    /** Stop loss configuration */
+    stopLoss: {
+        /** Price at which to trigger stop */
+        stopPrice: number;
+        /** Optional limit price for stop-limit (if omitted, uses market stop) */
+        limitPrice?: number;
+    };
+    /** Time in force: 'day' expires at market close, 'gtc' good till canceled */
+    timeInForce?: TimeInForce;
+    /** Enable extended hours trading */
+    extendedHours?: boolean;
+    /** Client-specified order ID for tracking */
+    clientOrderId?: string;
+}
+/**
+ * Result of a bracket order submission.
+ */
+export interface BracketOrderResult {
+    /** The parent/entry order */
+    entryOrder: AlpacaOrder;
+    /** The take profit leg */
+    takeProfitLeg: AlpacaOrder | null;
+    /** The stop loss leg */
+    stopLossLeg: AlpacaOrder | null;
+    /** All legs combined */
+    allOrders: AlpacaOrder[];
+}
+/**
+ * Create a bracket order (entry + take profit + stop loss).
+ *
+ * A bracket order ensures that when the entry fills:
+ * - A take profit limit order is placed
+ * - A stop loss order is placed
+ * - If either TP or SL fills, the other is automatically canceled (OCO behavior)
+ *
+ * @param executor - The order executor (AlpacaTradingAPI or AlpacaClient)
+ * @param params - The bracket order parameters
+ * @returns The bracket order result containing entry and leg orders
+ *
+ * @example
+ * ```typescript
+ * const api = AlpacaTradingAPI.new(credentials);
+ * const result = await createBracketOrder(
+ *   { createOrder: (p) => api.makeRequest('/orders', 'POST', p) },
+ *   {
+ *     symbol: 'AAPL',
+ *     qty: 100,
+ *     side: 'buy',
+ *     type: 'limit',
+ *     limitPrice: 150.00,
+ *     takeProfit: { limitPrice: 160.00 },
+ *     stopLoss: { stopPrice: 145.00 },
+ *     timeInForce: 'gtc',
+ *   }
+ * );
+ * ```
+ */
+export declare function createBracketOrder(executor: BracketOrderExecutor, params: BracketOrderParams): Promise<BracketOrderResult>;
+/**
+ * Parameters for creating a protective bracket on an existing position.
+ */
+export interface ProtectiveBracketParams {
+    /** Stock symbol */
+    symbol: string;
+    /** Number of shares to protect */
+    qty: number;
+    /** Side is always 'sell' to close a long position */
+    side: 'sell';
+    /** Take profit configuration */
+    takeProfit: {
+        /** Price at which to take profit */
+        limitPrice: number;
+    };
+    /** Stop loss configuration */
+    stopLoss: {
+        /** Price at which to trigger stop */
+        stopPrice: number;
+        /** Optional limit price for stop-limit */
+        limitPrice?: number;
+    };
+    /** Time in force: 'day' expires at market close, 'gtc' good till canceled */
+    timeInForce?: TimeInForce;
+}
+/**
+ * Create a bracket order for an existing position (protective bracket).
+ * Useful for adding stop loss and take profit to a position that was entered without them.
+ *
+ * Note: This creates an OCO (One-Cancels-Other) order rather than a full bracket
+ * because we already have the position - we just need the exit legs.
+ *
+ * @param executor - The order executor (AlpacaTradingAPI or AlpacaClient)
+ * @param params - The protective bracket parameters
+ * @returns The bracket order result
+ *
+ * @example
+ * ```typescript
+ * // Add protection to an existing long position
+ * const result = await createProtectiveBracket(
+ *   executor,
+ *   {
+ *     symbol: 'AAPL',
+ *     qty: 100,
+ *     side: 'sell',
+ *     takeProfit: { limitPrice: 160.00 },
+ *     stopLoss: { stopPrice: 145.00 },
+ *     timeInForce: 'gtc',
+ *   }
+ * );
+ * ```
+ */
+export declare function createProtectiveBracket(executor: BracketOrderExecutor, params: ProtectiveBracketParams): Promise<BracketOrderResult>;
+/**
+ * Creates an adapter to use AlpacaTradingAPI as a BracketOrderExecutor.
+ *
+ * @param api - Instance of AlpacaTradingAPI
+ * @returns BracketOrderExecutor compatible with bracket order functions
+ *
+ * @example
+ * ```typescript
+ * const api = AlpacaTradingAPI.new(credentials);
+ * const executor = createExecutorFromTradingAPI(api);
+ * const result = await createBracketOrder(executor, params);
+ * ```
+ */
+export declare function createExecutorFromTradingAPI(api: {
+    makeRequest: (endpoint: string, method: string, body?: unknown) => Promise<AlpacaOrder>;
+}): BracketOrderExecutor;
+declare const _default: {
+    createBracketOrder: typeof createBracketOrder;
+    createProtectiveBracket: typeof createProtectiveBracket;
+    createExecutorFromTradingAPI: typeof createExecutorFromTradingAPI;
+};
+export default _default;
+//# sourceMappingURL=bracket-orders.d.ts.map

package/dist/types/alpaca/trading/bracket-orders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bracket-orders.d.ts","sourceRoot":"","sources":["../../../../src/alpaca/trading/bracket-orders.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAYlG;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,uEAAuE;IACvE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,UAAU,EAAE;QACV,oCAAoC;QACpC,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,8BAA8B;IAC9B,QAAQ,EAAE;QACR,qCAAqC;QACrC,SAAS,EAAE,MAAM,CAAC;QAClB,yEAAyE;QACzE,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,6EAA6E;IAC7E,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,oCAAoC;IACpC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,UAAU,EAAE,WAAW,CAAC;IACxB,0BAA0B;IAC1B,aAAa,EAAE,WAAW,GAAG,IAAI,CAAC;IAClC,wBAAwB;IACxB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,wBAAwB;IACxB,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B;AAwDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAkF7B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,UAAU,EAAE;QACV,oCAAoC;QACpC,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,8BAA8B;IAC9B,QAAQ,EAAE;QACR,qCAAqC;QACrC,SAAS,EAAE,MAAM,CAAC;QAClB,0CAA0C;QAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,6EAA6E;IAC7E,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAwE7B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE;IAChD,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CACzF,GAAG,oBAAoB,CAMvB;;;;;;AAED,wBAIE"}