@adaptic/utils 0.0.382 → 0.1.0

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

@@ -0,0 +1,13 @@
+export { createBracketOrder, createProtectiveBracket, createExecutorFromTradingAPI, BracketOrderParams, BracketOrderResult, BracketOrderExecutor, ProtectiveBracketParams, } from './bracket-orders';
+export { default as bracketOrders } from './bracket-orders';
+export { getAccountDetails, getAccountConfiguration, updateAccountConfiguration, getPortfolioHistory, checkTradingEligibility, getBuyingPower, getOptionsTradingLevel, getPDTStatus, getDailyReturns, calculatePeriodPerformance, getEquityCurve, getAccountSummary, isMarginAccount, getMarginInfo, TradingEligibility, BuyingPowerBreakdown, PDTStatus, DailyReturn, PeriodPerformance, EquityCurvePoint, } from './account';
+export { default as account } from './account';
+export { getOrdersBySymbol, getOpenOrders as getOpenOrdersQuery, getFilledOrders, getOrderHistory, getAllOrders, waitForOrderFill, isOrderFillable, isOrderFilled, isOrderTerminal as isOrderTerminalStatus, isOrderOpen, calculateOrderValue, calculateTotalFilledValue, formatOrderSummary, formatOrderForLog, roundPriceForAlpaca, roundPriceForAlpacaNumber, groupOrdersBySymbol, groupOrdersByStatus, filterOrdersByDateRange, sortOrdersByDate, GetAllOrdersParams, GetFilledOrdersParams, GetOrderHistoryParams, OrderHistoryResult, WaitForOrderFillParams, WaitForOrderFillResult, OrderSummary, } from './order-utils';
+export { default as orderUtils } from './order-utils';
+export { createTrailingStop, updateTrailingStop, getTrailingStopHWM, cancelTrailingStop, createPortfolioTrailingStops, getOpenTrailingStops, hasActiveTrailingStop, cancelTrailingStopsForSymbol, TrailingStopParams, TrailingStopHWMResult, PortfolioTrailingStopParams, TrailingStopValidationError, } from './trailing-stops';
+export { default as trailingStops } from './trailing-stops';
+export { createOCOOrder, cancelOCOOrder, getOCOOrderStatus, protectLongPosition, protectShortPosition, OCOOrderParams, OCOOrderResult, } from './oco-orders';
+export { default as ocoOrders } from './oco-orders';
+export { createOTOOrder, cancelOTOOrder, getOTOOrderStatus, buyWithStopLoss, buyWithTrailingStop, limitBuyWithTakeProfit, shortWithStopLoss, entryWithPercentStopLoss, OTOOrderParams, OTOOrderResult, DependentOrderConfig, DependentOrderType, } from './oto-orders';
+export { default as otoOrders } from './oto-orders';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/alpaca/trading/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,4BAA4B,EAC5B,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG5D,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,0BAA0B,EAC1B,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACtB,YAAY,EACZ,eAAe,EACf,0BAA0B,EAC1B,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAG/C,OAAO,EAEL,iBAAiB,EACjB,aAAa,IAAI,kBAAkB,EACnC,eAAe,EACf,eAAe,EACf,YAAY,EACZ,gBAAgB,EAEhB,eAAe,EACf,aAAa,EACb,eAAe,IAAI,qBAAqB,EACxC,WAAW,EAEX,mBAAmB,EACnB,yBAAyB,EAEzB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EAEzB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAEhB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AAGtD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,4BAA4B,EAC5B,oBAAoB,EACpB,qBAAqB,EACrB,4BAA4B,EAC5B,kBAAkB,EAClB,qBAAqB,EACrB,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG5D,OAAO,EACL,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,EACL,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,203 @@
+/**
+ * OCO (One-Cancels-Other) Order Module
+ *
+ * OCO orders consist of two orders where filling one automatically cancels the other.
+ * This is commonly used for protective strategies where you want to either:
+ * - Take profit at a target price, OR
+ * - Stop loss at a predetermined level
+ *
+ * When either order fills, Alpaca automatically cancels the other order.
+ *
+ * @module oco-orders
+ */
+import { AlpacaClient } from '../client';
+import { AlpacaOrder, OrderSide, TimeInForce } from '../../types/alpaca-types';
+/**
+ * OCO Order Parameters
+ * Creates two orders where filling one cancels the other.
+ *
+ * @example
+ * // Protect a long position with take profit at $150 OR stop loss at $130
+ * const params: OCOOrderParams = {
+ *   symbol: 'AAPL',
+ *   qty: 100,
+ *   side: 'sell', // Selling to close long position
+ *   takeProfit: {
+ *     limitPrice: 150.00
+ *   },
+ *   stopLoss: {
+ *     stopPrice: 130.00,
+ *     limitPrice: 129.50 // Optional: creates stop-limit instead of stop
+ *   },
+ *   timeInForce: 'gtc'
+ * };
+ */
+export interface OCOOrderParams {
+    /** Symbol of the asset to trade */
+    symbol: string;
+    /** Quantity of shares to trade */
+    qty: number;
+    /** Order side - typically 'sell' for protecting long positions, 'buy' for short */
+    side: OrderSide;
+    /** Take profit limit order configuration */
+    takeProfit: {
+        /** Limit price for take profit order */
+        limitPrice: number;
+    };
+    /** Stop loss order configuration */
+    stopLoss: {
+        /** Stop trigger price */
+        stopPrice: number;
+        /** Optional limit price - if provided, creates stop-limit instead of stop market */
+        limitPrice?: number;
+    };
+    /** Time in force for both orders (default: 'gtc') */
+    timeInForce?: TimeInForce;
+}
+/**
+ * Result of OCO order creation
+ * Contains both leg orders and helper accessors
+ */
+export interface OCOOrderResult {
+    /** The take profit limit order */
+    takeProfitOrder: AlpacaOrder;
+    /** The stop loss order */
+    stopLossOrder: AlpacaOrder;
+    /** All orders in the OCO group */
+    allOrders: AlpacaOrder[];
+    /** Parent order ID (can be used for cancellation) */
+    parentOrderId: string;
+}
+/**
+ * Create an OCO order (take profit OR stop loss)
+ *
+ * Use this to protect an existing position with automatic cancellation
+ * of the remaining order when one fills.
+ *
+ * @param client - AlpacaClient instance
+ * @param params - OCO order parameters
+ * @returns OCO order result with both leg orders
+ *
+ * @example
+ * // Protect 100 shares of AAPL long position
+ * // Take profit at $155, stop loss at $145
+ * const result = await createOCOOrder(client, {
+ *   symbol: 'AAPL',
+ *   qty: 100,
+ *   side: 'sell',
+ *   takeProfit: { limitPrice: 155.00 },
+ *   stopLoss: { stopPrice: 145.00 },
+ *   timeInForce: 'gtc'
+ * });
+ *
+ * console.log('Take profit order:', result.takeProfitOrder.id);
+ * console.log('Stop loss order:', result.stopLossOrder.id);
+ *
+ * @example
+ * // Use stop-limit instead of stop-market for stop loss
+ * const result = await createOCOOrder(client, {
+ *   symbol: 'TSLA',
+ *   qty: 50,
+ *   side: 'sell',
+ *   takeProfit: { limitPrice: 280.00 },
+ *   stopLoss: {
+ *     stopPrice: 240.00,
+ *     limitPrice: 238.00 // Limit price for stop-limit order
+ *   },
+ *   timeInForce: 'gtc'
+ * });
+ *
+ * @example
+ * // Protect a short position (buying to close)
+ * const result = await createOCOOrder(client, {
+ *   symbol: 'NVDA',
+ *   qty: 25,
+ *   side: 'buy', // Buy to close short
+ *   takeProfit: { limitPrice: 380.00 }, // Take profit at lower price
+ *   stopLoss: { stopPrice: 420.00 }, // Stop loss at higher price
+ *   timeInForce: 'gtc'
+ * });
+ */
+export declare function createOCOOrder(client: AlpacaClient, params: OCOOrderParams): Promise<OCOOrderResult>;
+/**
+ * Cancel an OCO order group by parent order ID
+ * This will cancel both the take profit and stop loss orders
+ *
+ * @param client - AlpacaClient instance
+ * @param parentOrderId - The parent order ID from OCOOrderResult
+ *
+ * @example
+ * const result = await createOCOOrder(client, params);
+ * // Later...
+ * await cancelOCOOrder(client, result.parentOrderId);
+ */
+export declare function cancelOCOOrder(client: AlpacaClient, parentOrderId: string): Promise<void>;
+/**
+ * Get the status of an OCO order group
+ *
+ * @param client - AlpacaClient instance
+ * @param parentOrderId - The parent order ID from OCOOrderResult
+ * @returns The parent order with leg status information
+ *
+ * @example
+ * const result = await createOCOOrder(client, params);
+ * const status = await getOCOOrderStatus(client, result.parentOrderId);
+ * console.log('Order status:', status.status);
+ * status.legs?.forEach(leg => {
+ *   console.log(`Leg ${leg.id}: ${leg.status}`);
+ * });
+ */
+export declare function getOCOOrderStatus(client: AlpacaClient, parentOrderId: string): Promise<AlpacaOrder>;
+/**
+ * Helper to create OCO order for protecting a long position
+ * Convenience wrapper with sensible defaults for long protection
+ *
+ * @param client - AlpacaClient instance
+ * @param symbol - Stock symbol
+ * @param qty - Number of shares to protect
+ * @param takeProfitPrice - Price to take profit
+ * @param stopLossPrice - Price to stop loss
+ * @param stopLimitPrice - Optional limit price for stop-limit order
+ *
+ * @example
+ * // Simple long protection
+ * const result = await protectLongPosition(
+ *   client,
+ *   'AAPL',
+ *   100,
+ *   155.00, // Take profit
+ *   145.00  // Stop loss
+ * );
+ */
+export declare function protectLongPosition(client: AlpacaClient, symbol: string, qty: number, takeProfitPrice: number, stopLossPrice: number, stopLimitPrice?: number): Promise<OCOOrderResult>;
+/**
+ * Helper to create OCO order for protecting a short position
+ * Convenience wrapper with sensible defaults for short protection
+ *
+ * @param client - AlpacaClient instance
+ * @param symbol - Stock symbol
+ * @param qty - Number of shares to cover
+ * @param takeProfitPrice - Price to take profit (lower than current)
+ * @param stopLossPrice - Price to stop loss (higher than current)
+ * @param stopLimitPrice - Optional limit price for stop-limit order
+ *
+ * @example
+ * // Simple short protection
+ * const result = await protectShortPosition(
+ *   client,
+ *   'TSLA',
+ *   50,
+ *   200.00, // Take profit at lower price
+ *   260.00  // Stop loss at higher price
+ * );
+ */
+export declare function protectShortPosition(client: AlpacaClient, symbol: string, qty: number, takeProfitPrice: number, stopLossPrice: number, stopLimitPrice?: number): Promise<OCOOrderResult>;
+declare const _default: {
+    createOCOOrder: typeof createOCOOrder;
+    cancelOCOOrder: typeof cancelOCOOrder;
+    getOCOOrderStatus: typeof getOCOOrderStatus;
+    protectLongPosition: typeof protectLongPosition;
+    protectShortPosition: typeof protectShortPosition;
+};
+export default _default;
+//# sourceMappingURL=oco-orders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"oco-orders.d.ts","sourceRoot":"","sources":["../../../../src/alpaca/trading/oco-orders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAQ/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,mFAAmF;IACnF,IAAI,EAAE,SAAS,CAAC;IAChB,4CAA4C;IAC5C,UAAU,EAAE;QACV,wCAAwC;QACxC,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,oCAAoC;IACpC,QAAQ,EAAE;QACR,yBAAyB;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,oFAAoF;QACpF,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,qDAAqD;IACrD,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,eAAe,EAAE,WAAW,CAAC;IAC7B,0BAA0B;IAC1B,aAAa,EAAE,WAAW,CAAC;IAC3B,kCAAkC;IAClC,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;CACvB;AAiED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,cAAc,CAAC,CAoFzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,EACpB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,WAAW,CAAC,CAkBtB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,CAYzB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC,CAYzB;;;;;;;;AAED,wBAME"}

package/dist/types/alpaca/trading/order-utils.d.ts

@@ -0,0 +1,404 @@
+/**
+ * Order Query Utilities for Alpaca Trading
+ *
+ * Provides utility functions for querying, filtering, and managing Alpaca orders.
+ * Includes auto-pagination, order status helpers, and formatting utilities.
+ *
+ * @module order-utils
+ */
+import { AlpacaClient } from '../client';
+import { AlpacaOrder, GetOrdersParams } from '../../types/alpaca-types';
+/**
+ * Parameters for getAllOrders with pagination support
+ */
+export interface GetAllOrdersParams extends GetOrdersParams {
+    /** If true, fetches all orders by paginating through results */
+    fetchAll?: boolean;
+    /** Delay between pagination requests in ms (default: 300) */
+    paginationDelayMs?: number;
+}
+/**
+ * Parameters for getFilledOrders
+ */
+export interface GetFilledOrdersParams {
+    /** Start date for the date range (inclusive) */
+    startDate: Date;
+    /** End date for the date range (inclusive) */
+    endDate: Date;
+    /** Optional symbols to filter by */
+    symbols?: string[];
+    /** Optional side filter */
+    side?: 'buy' | 'sell';
+}
+/**
+ * Parameters for getOrderHistory with pagination
+ */
+export interface GetOrderHistoryParams {
+    /** Number of orders per page (max 500) */
+    pageSize?: number;
+    /** Starting page number (1-indexed) */
+    page?: number;
+    /** Optional symbols to filter by */
+    symbols?: string[];
+    /** Optional status filter */
+    status?: 'open' | 'closed' | 'all';
+    /** Optional side filter */
+    side?: 'buy' | 'sell';
+    /** Sort direction */
+    direction?: 'asc' | 'desc';
+}
+/**
+ * Result of paginated order history
+ */
+export interface OrderHistoryResult {
+    /** Orders for the current page */
+    orders: AlpacaOrder[];
+    /** Current page number */
+    page: number;
+    /** Number of orders per page */
+    pageSize: number;
+    /** Total number of orders fetched so far */
+    totalFetched: number;
+    /** Whether there are more orders to fetch */
+    hasMore: boolean;
+}
+/**
+ * Parameters for waitForOrderFill
+ */
+export interface WaitForOrderFillParams {
+    /** Order ID to monitor */
+    orderId: string;
+    /** Maximum time to wait in milliseconds (default: 60000) */
+    timeoutMs?: number;
+    /** Polling interval in milliseconds (default: 1000) */
+    pollIntervalMs?: number;
+}
+/**
+ * Result of waitForOrderFill
+ */
+export interface WaitForOrderFillResult {
+    /** Whether the order was filled */
+    filled: boolean;
+    /** The final order state */
+    order: AlpacaOrder;
+    /** Time elapsed in milliseconds */
+    elapsedMs: number;
+}
+/**
+ * Order summary for display/logging
+ */
+export interface OrderSummary {
+    id: string;
+    symbol: string;
+    side: string;
+    type: string;
+    status: string;
+    qty: string;
+    filledQty: string;
+    limitPrice: string | null;
+    stopPrice: string | null;
+    avgFillPrice: string | null;
+    createdAt: string;
+    filledAt: string | null;
+    timeInForce: string;
+    assetClass: string;
+}
+/**
+ * Get all orders for a specific symbol
+ *
+ * @param client - AlpacaClient instance
+ * @param symbol - Symbol to filter orders by (e.g., 'AAPL', 'BTCUSD')
+ * @param params - Optional additional filter parameters
+ * @returns Promise resolving to array of orders for the symbol
+ *
+ * @example
+ * ```typescript
+ * const client = createAlpacaClient({ apiKey, apiSecret, accountType: 'PAPER' });
+ * const orders = await getOrdersBySymbol(client, 'AAPL', { status: 'all' });
+ * console.log(`Found ${orders.length} orders for AAPL`);
+ * ```
+ */
+export declare function getOrdersBySymbol(client: AlpacaClient, symbol: string, params?: Omit<GetOrdersParams, 'symbols'>): Promise<AlpacaOrder[]>;
+/**
+ * Get only open orders
+ *
+ * @param client - AlpacaClient instance
+ * @param params - Optional filter parameters
+ * @returns Promise resolving to array of open orders
+ *
+ * @example
+ * ```typescript
+ * const openOrders = await getOpenOrders(client);
+ * console.log(`You have ${openOrders.length} open orders`);
+ * ```
+ */
+export declare function getOpenOrders(client: AlpacaClient, params?: Omit<GetOrdersParams, 'status'>): Promise<AlpacaOrder[]>;
+/**
+ * Get only filled orders within a date range
+ *
+ * @param client - AlpacaClient instance
+ * @param params - Date range and optional filter parameters
+ * @returns Promise resolving to array of filled orders in the date range
+ *
+ * @example
+ * ```typescript
+ * const startDate = new Date('2024-01-01');
+ * const endDate = new Date('2024-01-31');
+ * const filledOrders = await getFilledOrders(client, { startDate, endDate });
+ * console.log(`Found ${filledOrders.length} filled orders in January`);
+ * ```
+ */
+export declare function getFilledOrders(client: AlpacaClient, params: GetFilledOrdersParams): Promise<AlpacaOrder[]>;
+/**
+ * Get paginated order history with auto-pagination support
+ *
+ * @param client - AlpacaClient instance
+ * @param params - Pagination and filter parameters
+ * @returns Promise resolving to order history result with pagination info
+ *
+ * @example
+ * ```typescript
+ * // Get first page
+ * const result = await getOrderHistory(client, { pageSize: 100, page: 1 });
+ *
+ * // Get all pages
+ * let allOrders: AlpacaOrder[] = [];
+ * let page = 1;
+ * let hasMore = true;
+ *
+ * while (hasMore) {
+ *   const result = await getOrderHistory(client, { pageSize: 100, page });
+ *   allOrders = allOrders.concat(result.orders);
+ *   hasMore = result.hasMore;
+ *   page++;
+ * }
+ * ```
+ */
+export declare function getOrderHistory(client: AlpacaClient, params?: GetOrderHistoryParams): Promise<OrderHistoryResult>;
+/**
+ * Get all orders with automatic pagination
+ * Alpaca limits to 500 orders per request, so this function handles
+ * pagination automatically when fetchAll is true.
+ *
+ * @param client - AlpacaClient instance
+ * @param params - Query parameters with optional fetchAll flag
+ * @returns Promise resolving to array of all orders matching the criteria
+ *
+ * @example
+ * ```typescript
+ * // Fetch all closed orders
+ * const allOrders = await getAllOrders(client, {
+ *   status: 'closed',
+ *   fetchAll: true
+ * });
+ * console.log(`Total orders: ${allOrders.length}`);
+ * ```
+ */
+export declare function getAllOrders(client: AlpacaClient, params?: GetAllOrdersParams): Promise<AlpacaOrder[]>;
+/**
+ * Wait for an order to be filled or timeout
+ *
+ * @param client - AlpacaClient instance
+ * @param params - Order ID and timeout parameters
+ * @returns Promise resolving to fill result with order state and timing info
+ *
+ * @example
+ * ```typescript
+ * const order = await submitOrder(client, { ... });
+ *
+ * const result = await waitForOrderFill(client, {
+ *   orderId: order.id,
+ *   timeoutMs: 30000, // 30 seconds
+ *   pollIntervalMs: 500 // Poll every 500ms
+ * });
+ *
+ * if (result.filled) {
+ *   console.log(`Order filled at ${result.order.filled_avg_price}`);
+ * } else {
+ *   console.log(`Order not filled, status: ${result.order.status}`);
+ * }
+ * ```
+ */
+export declare function waitForOrderFill(client: AlpacaClient, params: WaitForOrderFillParams): Promise<WaitForOrderFillResult>;
+/**
+ * Check if an order can still be filled
+ *
+ * @param order - AlpacaOrder to check
+ * @returns True if the order can potentially still be filled
+ *
+ * @example
+ * ```typescript
+ * const order = await getOrder(client, orderId);
+ * if (isOrderFillable(order)) {
+ *   console.log('Order is still active and may be filled');
+ * } else {
+ *   console.log('Order cannot be filled anymore');
+ * }
+ * ```
+ */
+export declare function isOrderFillable(order: AlpacaOrder): boolean;
+/**
+ * Check if an order has been filled
+ *
+ * @param order - AlpacaOrder to check
+ * @returns True if the order has been filled
+ */
+export declare function isOrderFilled(order: AlpacaOrder): boolean;
+/**
+ * Check if an order is in a terminal state
+ *
+ * @param order - AlpacaOrder to check
+ * @returns True if the order is in a terminal state (no longer active)
+ */
+export declare function isOrderTerminal(order: AlpacaOrder): boolean;
+/**
+ * Check if an order is open (active, waiting to be filled)
+ *
+ * @param order - AlpacaOrder to check
+ * @returns True if the order is open
+ */
+export declare function isOrderOpen(order: AlpacaOrder): boolean;
+/**
+ * Calculate the total value of an order
+ * For filled orders, uses the filled quantity and average price.
+ * For unfilled orders, uses the order quantity and limit/stop price.
+ *
+ * @param order - AlpacaOrder to calculate value for
+ * @returns Total order value, or null if cannot be calculated
+ *
+ * @example
+ * ```typescript
+ * const order = await getOrder(client, orderId);
+ * const value = calculateOrderValue(order);
+ * if (value !== null) {
+ *   console.log(`Order value: $${value.toFixed(2)}`);
+ * }
+ * ```
+ */
+export declare function calculateOrderValue(order: AlpacaOrder): number | null;
+/**
+ * Format an order for logging or display
+ *
+ * @param order - AlpacaOrder to format
+ * @returns OrderSummary with formatted fields
+ *
+ * @example
+ * ```typescript
+ * const order = await getOrder(client, orderId);
+ * const summary = formatOrderSummary(order);
+ * console.log(`${summary.side.toUpperCase()} ${summary.qty} ${summary.symbol} @ ${summary.avgFillPrice || summary.limitPrice || 'MARKET'}`);
+ * ```
+ */
+export declare function formatOrderSummary(order: AlpacaOrder): OrderSummary;
+/**
+ * Format order summary as a single-line string for logging
+ *
+ * @param order - AlpacaOrder to format
+ * @returns Formatted string for logging
+ *
+ * @example
+ * ```typescript
+ * const order = await getOrder(client, orderId);
+ * console.log(formatOrderForLog(order));
+ * // Output: "BUY 100 AAPL LIMIT @ $150.00 [filled] - filled 100 @ $149.95"
+ * ```
+ */
+export declare function formatOrderForLog(order: AlpacaOrder): string;
+/**
+ * Round prices correctly for Alpaca API
+ * Uses 2 decimal places for prices >= $1
+ * Uses 4 decimal places for prices < $1 (penny stocks, crypto)
+ *
+ * @param price - Price to round
+ * @returns Formatted price string
+ *
+ * @example
+ * ```typescript
+ * roundPriceForAlpaca(150.12345) // "150.12"
+ * roundPriceForAlpaca(0.12345)   // "0.1235"
+ * roundPriceForAlpaca(0.00123)   // "0.0012"
+ * ```
+ */
+export declare function roundPriceForAlpaca(price: number): string;
+/**
+ * Round price as a number for calculations
+ *
+ * @param price - Price to round
+ * @returns Rounded price as number
+ */
+export declare function roundPriceForAlpacaNumber(price: number): number;
+/**
+ * Get orders grouped by symbol
+ *
+ * @param orders - Array of orders to group
+ * @returns Map of symbol to orders
+ *
+ * @example
+ * ```typescript
+ * const orders = await getAllOrders(client, { fetchAll: true });
+ * const bySymbol = groupOrdersBySymbol(orders);
+ *
+ * for (const [symbol, symbolOrders] of bySymbol) {
+ *   console.log(`${symbol}: ${symbolOrders.length} orders`);
+ * }
+ * ```
+ */
+export declare function groupOrdersBySymbol(orders: AlpacaOrder[]): Map<string, AlpacaOrder[]>;
+/**
+ * Get orders grouped by status
+ *
+ * @param orders - Array of orders to group
+ * @returns Map of status to orders
+ */
+export declare function groupOrdersByStatus(orders: AlpacaOrder[]): Map<string, AlpacaOrder[]>;
+/**
+ * Calculate total filled value across multiple orders
+ *
+ * @param orders - Array of orders
+ * @returns Total filled value
+ */
+export declare function calculateTotalFilledValue(orders: AlpacaOrder[]): number;
+/**
+ * Filter orders by date range
+ *
+ * @param orders - Array of orders to filter
+ * @param startDate - Start of date range (inclusive)
+ * @param endDate - End of date range (inclusive)
+ * @returns Filtered orders
+ */
+export declare function filterOrdersByDateRange(orders: AlpacaOrder[], startDate: Date, endDate: Date): AlpacaOrder[];
+/**
+ * Sort orders by created date
+ *
+ * @param orders - Array of orders to sort
+ * @param direction - Sort direction ('asc' or 'desc')
+ * @returns Sorted orders (new array)
+ */
+export declare function sortOrdersByDate(orders: AlpacaOrder[], direction?: 'asc' | 'desc'): AlpacaOrder[];
+/**
+ * Default export containing all order utility functions
+ */
+declare const _default: {
+    getOrdersBySymbol: typeof getOrdersBySymbol;
+    getOpenOrders: typeof getOpenOrders;
+    getFilledOrders: typeof getFilledOrders;
+    getOrderHistory: typeof getOrderHistory;
+    getAllOrders: typeof getAllOrders;
+    waitForOrderFill: typeof waitForOrderFill;
+    isOrderFillable: typeof isOrderFillable;
+    isOrderFilled: typeof isOrderFilled;
+    isOrderTerminal: typeof isOrderTerminal;
+    isOrderOpen: typeof isOrderOpen;
+    calculateOrderValue: typeof calculateOrderValue;
+    calculateTotalFilledValue: typeof calculateTotalFilledValue;
+    formatOrderSummary: typeof formatOrderSummary;
+    formatOrderForLog: typeof formatOrderForLog;
+    roundPriceForAlpaca: typeof roundPriceForAlpaca;
+    roundPriceForAlpacaNumber: typeof roundPriceForAlpacaNumber;
+    groupOrdersBySymbol: typeof groupOrdersBySymbol;
+    groupOrdersByStatus: typeof groupOrdersByStatus;
+    filterOrdersByDateRange: typeof filterOrdersByDateRange;
+    sortOrdersByDate: typeof sortOrdersByDate;
+};
+export default _default;
+//# sourceMappingURL=order-utils.d.ts.map

package/dist/types/alpaca/trading/order-utils.d.ts.map

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