@adaptic/utils 0.1.49 → 0.1.50

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

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,CAkBtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA4B9B;;;;;AAED,wBAGE"}