@adaptic/utils 0.0.383 → 0.0.901

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,GACvB,OAAO,GACP,OAAO,GACP,KAAK,GACL,cAAc,GACd,OAAO,GACP,WAAW,GACX,cAAc,CAAC;AAEnB;;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,CACjC,OAAO,EAAE,mBAAmB,GAC3B,aAAa,CAoCf;;;;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,EACL,WAAW,EACX,SAAS,EACT,WAAW,EACX,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAYlC;;;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;AAoED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CA+F7B;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,CAsF7B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE;IAChD,WAAW,EAAE,CACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO,KACX,OAAO,CAAC,WAAW,CAAC,CAAC;CAC3B,GAAG,oBAAoB,CAMvB;;;;;;AAED,wBAIE"}

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

@@ -0,0 +1,99 @@
+/**
+ * Market Clock and Calendar Module
+ * Provides access to market hours (clock) and trading calendar via the Alpaca API
+ */
+import { AlpacaClient } from "../client";
+/**
+ * Alpaca market clock representing the current market status and next session times.
+ * Corresponds to the response from GET /v2/clock.
+ */
+export interface AlpacaClock {
+    /** ISO 8601 timestamp of the current server time */
+    timestamp: string;
+    /** Whether the market is currently open for trading */
+    is_open: boolean;
+    /** ISO 8601 timestamp of the next market open */
+    next_open: string;
+    /** ISO 8601 timestamp of the next market close */
+    next_close: string;
+}
+/**
+ * A single trading day entry from the Alpaca market calendar.
+ * Corresponds to one element in the response from GET /v2/calendar.
+ */
+export interface AlpacaCalendarDay {
+    /** The date in YYYY-MM-DD format */
+    date: string;
+    /** The market open time in HH:MM format (US Eastern) */
+    open: string;
+    /** The market close time in HH:MM format (US Eastern) */
+    close: string;
+    /** The settlement date in YYYY-MM-DD format */
+    settlement_date: string;
+}
+/**
+ * Options for fetching the Alpaca market calendar.
+ */
+export interface GetAlpacaCalendarOptions {
+    /** Start date for the calendar range (inclusive). Defaults to today if omitted. */
+    start?: Date;
+    /** End date for the calendar range (inclusive). Defaults to today if omitted. */
+    end?: Date;
+}
+/**
+ * Fetches the current market clock from Alpaca (GET /v2/clock).
+ *
+ * Returns the current server time, whether the market is open, and the next
+ * open/close timestamps. Useful for determining whether trading is currently
+ * possible before placing orders.
+ *
+ * @param client - An initialized AlpacaClient instance
+ * @returns Promise resolving to the current market clock status
+ *
+ * @example
+ * ```ts
+ * const clock = await getAlpacaClock(client);
+ * if (clock.is_open) {
+ *   console.log('Market is open, next close:', clock.next_close);
+ * } else {
+ *   console.log('Market closed, next open:', clock.next_open);
+ * }
+ * ```
+ *
+ * @throws {Error} If the Alpaca API request fails
+ */
+export declare function getAlpacaClock(client: AlpacaClient): Promise<AlpacaClock>;
+/**
+ * Fetches the market trading calendar from Alpaca (GET /v2/calendar).
+ *
+ * Returns the scheduled open and close times for each trading day within the
+ * requested date range. The calendar accounts for market holidays and early
+ * closures. Dates default to today when omitted.
+ *
+ * @param client - An initialized AlpacaClient instance
+ * @param options - Optional start/end dates for the calendar range
+ * @returns Promise resolving to an array of trading calendar days
+ *
+ * @example
+ * ```ts
+ * // Fetch the next 5 trading days
+ * const today = new Date();
+ * const nextWeek = new Date(today);
+ * nextWeek.setDate(today.getDate() + 7);
+ *
+ * const calendar = await getAlpacaCalendar(client, {
+ *   start: today,
+ *   end: nextWeek,
+ * });
+ * console.log('Trading days this week:', calendar.length);
+ * ```
+ *
+ * @throws {Error} If the Alpaca API request fails
+ */
+export declare function getAlpacaCalendar(client: AlpacaClient, options?: GetAlpacaCalendarOptions): Promise<AlpacaCalendarDay[]>;
+declare const _default: {
+    getAlpacaClock: typeof getAlpacaClock;
+    getAlpacaCalendar: typeof getAlpacaCalendar;
+};
+export default _default;
+//# sourceMappingURL=clock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../../../src/alpaca/trading/clock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAQzC;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,mFAAmF;IACnF,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,iFAAiF;IACjF,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAeD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,WAAW,CAAC,CAetB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAwB9B;;;;;AAED,wBAGE"}

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

@@ -0,0 +1,15 @@
+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";
+export { getAlpacaClock, getAlpacaCalendar, type AlpacaClock, type AlpacaCalendarDay, type GetAlpacaCalendarOptions, } from "./clock";
+export { default as clock } from "./clock";
+//# 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;AAGpD,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,GAC9B,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,SAAS,CAAC"}