@adaptic/utils 0.0.383 → 0.0.901

package/dist/test.js

@@ -493,7 +493,7 @@ createChalk({level: stderrColor ? stderrColor.level : 0});
 
 class DisplayManager {
     static instance;
-    promptText = '';
+    promptText = "";
     constructor() { }
     static getInstance() {
         if (!DisplayManager.instance) {
@@ -513,20 +513,22 @@ class DisplayManager {
         cursorTo(process.stdout, 0);
         // Format the timestamp
         const date = new Date();
-        const timestamp = date.toLocaleString('en-US', { timeZone: 'America/New_York' });
+        const timestamp = date.toLocaleString("en-US", {
+            timeZone: "America/New_York",
+        });
         const account = options?.account;
         const symbol = options?.symbol;
         // Build the log message
-        let logMessage = `[${timestamp}]${options?.source ? ` [${options.source}] ` : ''}${account ? ` [${account}] ` : ''}${symbol ? ` [${symbol}] ` : ''}${message}`;
+        let logMessage = `[${timestamp}]${options?.source ? ` [${options.source}] ` : ""}${account ? ` [${account}] ` : ""}${symbol ? ` [${symbol}] ` : ""}${message}`;
         // Add color based on type
-        if (options?.type === 'error') {
+        if (options?.type === "error") {
             logMessage = chalk.red(logMessage);
         }
-        else if (options?.type === 'warn') {
+        else if (options?.type === "warn") {
             logMessage = chalk.yellow(logMessage);
         }
         // Write the log message
-        process.stdout.write(logMessage + '\n');
+        process.stdout.write(logMessage + "\n");
         // Log to file
         if (symbol) {
             // Log to symbol-specific file if symbol is provided
@@ -545,20 +547,20 @@ class DisplayManager {
     writeSymbolLog(symbol, date, logMessage, options) {
         try {
             // Create logs directory if it doesn't exist
-            if (!fs.existsSync('logs')) {
-                fs.mkdirSync('logs', { recursive: true });
+            if (!fs.existsSync("logs")) {
+                fs.mkdirSync("logs", { recursive: true });
             }
             // Format date for filename: YYYY-MM-DD
             const year = date.getFullYear();
-            const month = String(date.getMonth() + 1).padStart(2, '0');
-            const day = String(date.getDate()).padStart(2, '0');
+            const month = String(date.getMonth() + 1).padStart(2, "0");
+            const day = String(date.getDate()).padStart(2, "0");
             // Create filename: SYM-YYYY-MM-DD.log
             const filename = `${symbol}-${year}-${month}-${day}.log`;
-            const filePath = path.join('logs', filename);
+            const filePath = path.join("logs", filename);
             // Strip ANSI color codes from log message
-            const plainLogMessage = logMessage.replace(/\x1B\[\d+m/g, '');
+            const plainLogMessage = logMessage.replace(/\x1B\[\d+m/g, "");
             // Write to file (append if exists, create if not)
-            fs.appendFileSync(filePath, plainLogMessage + '\n');
+            fs.appendFileSync(filePath, plainLogMessage + "\n");
         }
         catch (error) {
             // Only log to console - don't try to log to file again to avoid potential infinite loop
@@ -571,21 +573,21 @@ class DisplayManager {
     writeGenericLog(date, logMessage, options) {
         try {
             // Create logs directory if it doesn't exist
-            if (!fs.existsSync('logs')) {
-                fs.mkdirSync('logs', { recursive: true });
+            if (!fs.existsSync("logs")) {
+                fs.mkdirSync("logs", { recursive: true });
             }
             // Format date for filename: YYYY-MM-DD
             const year = date.getFullYear();
-            const month = String(date.getMonth() + 1).padStart(2, '0');
-            const day = String(date.getDate()).padStart(2, '0');
+            const month = String(date.getMonth() + 1).padStart(2, "0");
+            const day = String(date.getDate()).padStart(2, "0");
             // Create filename: system-YYYY-MM-DD.log
-            const source = options?.source?.toLowerCase().replace(/\s+/g, '-') || 'system';
+            const source = options?.source?.toLowerCase().replace(/\s+/g, "-") || "system";
             const filename = `${source}-${year}-${month}-${day}.log`;
-            const filePath = path.join('logs', filename);
+            const filePath = path.join("logs", filename);
             // Strip ANSI color codes from log message
-            const plainLogMessage = logMessage.replace(/\x1B\[\d+m/g, '');
+            const plainLogMessage = logMessage.replace(/\x1B\[\d+m/g, "");
             // Write to file (append if exists, create if not)
-            fs.appendFileSync(filePath, plainLogMessage + '\n');
+            fs.appendFileSync(filePath, plainLogMessage + "\n");
         }
         catch (error) {
             // Only log to console - don't try to log to file again to avoid potential infinite loop
@@ -613,112 +615,206 @@ class DisplayManager {
  * @param options.symbol The trading symbol associated with this log.
  * @param options.logToFile Force logging to a file even when no symbol is provided.
  */
-function log$2(message, options = { source: 'Server', type: 'info' }) {
+function log$2(message, options = { source: "Server", type: "info" }) {
     const displayManager = DisplayManager.getInstance();
     displayManager.log(message, options);
 }
 
+/**
+ * Centralized API Endpoints Configuration
+ *
+ * This file defines all Alpaca API base URLs to ensure consistency
+ * across the codebase and make updates easier.
+ *
+ * API Version Guidelines:
+ * - Trading API: v2 (stable, production-ready)
+ * - Market Data (stocks): v2 (stable)
+ * - Market Data (crypto): v1beta3 (latest beta)
+ * - Market Data (options): v1beta1 (latest beta)
+ * - News API: v1beta1 (latest beta)
+ */
+/**
+ * Trading API base URLs (v2)
+ * Used for orders, positions, account management
+ */
+const TRADING_API = {
+    PAPER: "https://paper-api.alpaca.markets/v2",
+    LIVE: "https://api.alpaca.markets/v2",
+};
+/**
+ * Get trading API base URL for account type
+ */
+function getTradingApiUrl(accountType) {
+    return TRADING_API[accountType];
+}
+/**
+ * Market Data API base URLs
+ */
+const MARKET_DATA_API = {
+    /** Stock market data (v2) - bars, quotes, trades */
+    STOCKS: "https://data.alpaca.markets/v2",
+    /** Options market data (v1beta1) */
+    OPTIONS: "https://data.alpaca.markets/v1beta1"};
+/**
+ * WebSocket stream URLs
+ */
+const WEBSOCKET_STREAMS = {
+    /** Stock market data stream (v2) */
+    STOCKS: {
+        PRODUCTION: "wss://stream.data.alpaca.markets/v2/sip",
+        TEST: "wss://stream.data.alpaca.markets/v2/test",
+    },
+    /** Options market data stream (v1beta3) */
+    OPTIONS: {
+        PRODUCTION: "wss://stream.data.alpaca.markets/v1beta3/options",
+        SANDBOX: "wss://stream.data.sandbox.alpaca.markets/v1beta3/options",
+    },
+    /** Crypto market data stream (v1beta3) */
+    CRYPTO: {
+        PRODUCTION: "wss://stream.data.alpaca.markets/v1beta3/crypto/us",
+        SANDBOX: "wss://stream.data.sandbox.alpaca.markets/v1beta3/crypto/us",
+    },
+};
+/**
+ * Get stock stream WebSocket URL
+ */
+function getStockStreamUrl(mode = "PRODUCTION") {
+    return WEBSOCKET_STREAMS.STOCKS[mode];
+}
+/**
+ * Get options stream WebSocket URL
+ */
+function getOptionsStreamUrl(mode = "PRODUCTION") {
+    return WEBSOCKET_STREAMS.OPTIONS[mode];
+}
+/**
+ * Get crypto stream WebSocket URL
+ */
+function getCryptoStreamUrl(mode = "PRODUCTION") {
+    return WEBSOCKET_STREAMS.CRYPTO[mode];
+}
+
 // market-hours.ts
 const marketHolidays = {
     2024: {
-        'New Year\'s Day': { date: '2024-01-01' },
-        'Martin Luther King, Jr. Day': { date: '2024-01-15' },
-        'Washington\'s Birthday': { date: '2024-02-19' },
-        'Good Friday': { date: '2024-03-29' },
-        'Memorial Day': { date: '2024-05-27' },
-        'Juneteenth National Independence Day': { date: '2024-06-19' },
-        'Independence Day': { date: '2024-07-04' },
-        'Labor Day': { date: '2024-09-02' },
-        'Thanksgiving Day': { date: '2024-11-28' },
-        'Christmas Day': { date: '2024-12-25' }
+        "New Year's Day": { date: "2024-01-01" },
+        "Martin Luther King, Jr. Day": { date: "2024-01-15" },
+        "Washington's Birthday": { date: "2024-02-19" },
+        "Good Friday": { date: "2024-03-29" },
+        "Memorial Day": { date: "2024-05-27" },
+        "Juneteenth National Independence Day": { date: "2024-06-19" },
+        "Independence Day": { date: "2024-07-04" },
+        "Labor Day": { date: "2024-09-02" },
+        "Thanksgiving Day": { date: "2024-11-28" },
+        "Christmas Day": { date: "2024-12-25" },
     },
     2025: {
-        'New Year\'s Day': { date: '2025-01-01' },
-        'Jimmy Carter Memorial Day': { date: '2025-01-09' },
-        'Martin Luther King, Jr. Day': { date: '2025-01-20' },
-        'Washington\'s Birthday': { date: '2025-02-17' },
-        'Good Friday': { date: '2025-04-18' },
-        'Memorial Day': { date: '2025-05-26' },
-        'Juneteenth National Independence Day': { date: '2025-06-19' },
-        'Independence Day': { date: '2025-07-04' },
-        'Labor Day': { date: '2025-09-01' },
-        'Thanksgiving Day': { date: '2025-11-27' },
-        'Christmas Day': { date: '2025-12-25' }
+        "New Year's Day": { date: "2025-01-01" },
+        "Jimmy Carter Memorial Day": { date: "2025-01-09" },
+        "Martin Luther King, Jr. Day": { date: "2025-01-20" },
+        "Washington's Birthday": { date: "2025-02-17" },
+        "Good Friday": { date: "2025-04-18" },
+        "Memorial Day": { date: "2025-05-26" },
+        "Juneteenth National Independence Day": { date: "2025-06-19" },
+        "Independence Day": { date: "2025-07-04" },
+        "Labor Day": { date: "2025-09-01" },
+        "Thanksgiving Day": { date: "2025-11-27" },
+        "Christmas Day": { date: "2025-12-25" },
     },
     2026: {
-        'New Year\'s Day': { date: '2026-01-01' },
-        'Martin Luther King, Jr. Day': { date: '2026-01-19' },
-        'Washington\'s Birthday': { date: '2026-02-16' },
-        'Good Friday': { date: '2026-04-03' },
-        'Memorial Day': { date: '2026-05-25' },
-        'Juneteenth National Independence Day': { date: '2026-06-19' },
-        'Independence Day': { date: '2026-07-03' },
-        'Labor Day': { date: '2026-09-07' },
-        'Thanksgiving Day': { date: '2026-11-26' },
-        'Christmas Day': { date: '2026-12-25' }
-    }
+        "New Year's Day": { date: "2026-01-01" },
+        "Martin Luther King, Jr. Day": { date: "2026-01-19" },
+        "Washington's Birthday": { date: "2026-02-16" },
+        "Good Friday": { date: "2026-04-03" },
+        "Memorial Day": { date: "2026-05-25" },
+        "Juneteenth National Independence Day": { date: "2026-06-19" },
+        "Independence Day": { date: "2026-07-03" },
+        "Labor Day": { date: "2026-09-07" },
+        "Thanksgiving Day": { date: "2026-11-26" },
+        "Christmas Day": { date: "2026-12-25" },
+    },
+    2027: {
+        "New Year's Day": { date: "2027-01-01" },
+        "Martin Luther King, Jr. Day": { date: "2027-01-18" },
+        "Washington's Birthday": { date: "2027-02-15" },
+        "Good Friday": { date: "2027-03-26" },
+        "Memorial Day": { date: "2027-05-31" },
+        "Juneteenth National Independence Day": { date: "2027-06-18" },
+        "Independence Day": { date: "2027-07-05" },
+        "Labor Day": { date: "2027-09-06" },
+        "Thanksgiving Day": { date: "2027-11-25" },
+        "Christmas Day": { date: "2027-12-24" },
+    },
 };
 const marketEarlyCloses = {
     2024: {
-        '2024-07-03': {
-            date: '2024-07-03',
-            time: '13:00',
-            optionsTime: '13:15',
-            notes: 'Market closes early on Wednesday, July 3, 2024 at 1:00 p.m. (1:15 p.m. for eligible options). NYSE American Equities, NYSE Arca Equities, NYSE Chicago, and NYSE National late trading sessions will close at 5:00 p.m. Eastern Time.'
+        "2024-07-03": {
+            date: "2024-07-03",
+            time: "13:00",
+            optionsTime: "13:15",
+            notes: "Market closes early on Wednesday, July 3, 2024 at 1:00 p.m. (1:15 p.m. for eligible options). NYSE American Equities, NYSE Arca Equities, NYSE Chicago, and NYSE National late trading sessions will close at 5:00 p.m. Eastern Time.",
         },
-        '2024-11-29': {
-            date: '2024-11-29',
-            time: '13:00',
-            optionsTime: '13:15',
-            notes: 'Market closes early on Friday, November 29, 2024 at 1:00 p.m. (1:15 p.m. for eligible options). NYSE American Equities, NYSE Arca Equities, NYSE Chicago, and NYSE National late trading sessions will close at 5:00 p.m. Eastern Time.'
+        "2024-11-29": {
+            date: "2024-11-29",
+            time: "13:00",
+            optionsTime: "13:15",
+            notes: "Market closes early on Friday, November 29, 2024 at 1:00 p.m. (1:15 p.m. for eligible options). NYSE American Equities, NYSE Arca Equities, NYSE Chicago, and NYSE National late trading sessions will close at 5:00 p.m. Eastern Time.",
+        },
+        "2024-12-24": {
+            date: "2024-12-24",
+            time: "13:00",
+            optionsTime: "13:15",
+            notes: "Market closes early on Tuesday, December 24, 2024 at 1:00 p.m. (1:15 p.m. for eligible options). NYSE American Equities, NYSE Arca Equities, NYSE Chicago, and NYSE National late trading sessions will close at 5:00 p.m. Eastern Time.",
         },
-        '2024-12-24': {
-            date: '2024-12-24',
-            time: '13:00',
-            optionsTime: '13:15',
-            notes: 'Market closes early on Tuesday, December 24, 2024 at 1:00 p.m. (1:15 p.m. for eligible options). NYSE American Equities, NYSE Arca Equities, NYSE Chicago, and NYSE National late trading sessions will close at 5:00 p.m. Eastern Time.'
-        }
     },
     2025: {
-        '2025-07-03': {
-            date: '2025-07-03',
-            time: '13:00',
-            optionsTime: '13:15',
-            notes: 'Market closes early on Thursday, July 3, 2025 at 1:00 p.m. (1:15 p.m. for eligible options). NYSE American Equities, NYSE Arca Equities, NYSE Chicago, and NYSE National late trading sessions will close at 5:00 p.m. Eastern Time.'
+        "2025-07-03": {
+            date: "2025-07-03",
+            time: "13:00",
+            optionsTime: "13:15",
+            notes: "Market closes early on Thursday, July 3, 2025 at 1:00 p.m. (1:15 p.m. for eligible options). NYSE American Equities, NYSE Arca Equities, NYSE Chicago, and NYSE National late trading sessions will close at 5:00 p.m. Eastern Time.",
         },
-        '2025-11-28': {
-            date: '2025-11-28',
-            time: '13:00',
-            optionsTime: '13:15',
-            notes: 'Market closes early on Friday, November 28, 2025 at 1:00 p.m. (1:15 p.m. for eligible options). NYSE American Equities, NYSE Arca Equities, NYSE Chicago, and NYSE National late trading sessions will close at 5:00 p.m. Eastern Time.'
+        "2025-11-28": {
+            date: "2025-11-28",
+            time: "13:00",
+            optionsTime: "13:15",
+            notes: "Market closes early on Friday, November 28, 2025 at 1:00 p.m. (1:15 p.m. for eligible options). NYSE American Equities, NYSE Arca Equities, NYSE Chicago, and NYSE National late trading sessions will close at 5:00 p.m. Eastern Time.",
+        },
+        "2025-12-24": {
+            date: "2025-12-24",
+            time: "13:00",
+            optionsTime: "13:15",
+            notes: "Market closes early on Wednesday, December 24, 2025 at 1:00 p.m. (1:15 p.m. for eligible options). NYSE American Equities, NYSE Arca Equities, NYSE Chicago, and NYSE National late trading sessions will close at 5:00 p.m. Eastern Time.",
         },
-        '2025-12-24': {
-            date: '2025-12-24',
-            time: '13:00',
-            optionsTime: '13:15',
-            notes: 'Market closes early on Wednesday, December 24, 2025 at 1:00 p.m. (1:15 p.m. for eligible options). NYSE American Equities, NYSE Arca Equities, NYSE Chicago, and NYSE National late trading sessions will close at 5:00 p.m. Eastern Time.'
-        }
     },
     2026: {
-        '2026-07-02': {
-            date: '2026-07-02',
-            time: '13:00',
-            optionsTime: '13:15',
-            notes: 'Independence Day observed, market closes early at 1:00 p.m. (1:15 p.m. for eligible options). NYSE American Equities, NYSE Arca Equities, NYSE Chicago, and NYSE National late trading sessions will close at 5:00 p.m. Eastern Time.'
+        "2026-07-02": {
+            date: "2026-07-02",
+            time: "13:00",
+            optionsTime: "13:15",
+            notes: "Independence Day observed, market closes early at 1:00 p.m. (1:15 p.m. for eligible options). NYSE American Equities, NYSE Arca Equities, NYSE Chicago, and NYSE National late trading sessions will close at 5:00 p.m. Eastern Time.",
         },
-        '2026-11-27': {
-            date: '2026-11-27',
-            time: '13:00',
-            optionsTime: '13:15',
-            notes: 'Market closes early on Friday, November 27, 2026 at 1:00 p.m. (1:15 p.m. for eligible options). NYSE American Equities, NYSE Arca Equities, NYSE Chicago, and NYSE National late trading sessions will close at 5:00 p.m. Eastern Time.'
+        "2026-11-27": {
+            date: "2026-11-27",
+            time: "13:00",
+            optionsTime: "13:15",
+            notes: "Market closes early on Friday, November 27, 2026 at 1:00 p.m. (1:15 p.m. for eligible options). NYSE American Equities, NYSE Arca Equities, NYSE Chicago, and NYSE National late trading sessions will close at 5:00 p.m. Eastern Time.",
         },
-        '2026-12-24': {
-            date: '2026-12-24',
-            time: '13:00',
-            optionsTime: '13:15',
-            notes: 'Market closes early on Thursday, December 24, 2026 at 1:00 p.m. (1:15 p.m. for eligible options). NYSE American Equities, NYSE Arca Equities, NYSE Chicago, and NYSE National late trading sessions will close at 5:00 p.m. Eastern Time.'
-        }
-    }
+        "2026-12-24": {
+            date: "2026-12-24",
+            time: "13:00",
+            optionsTime: "13:15",
+            notes: "Market closes early on Thursday, December 24, 2026 at 1:00 p.m. (1:15 p.m. for eligible options). NYSE American Equities, NYSE Arca Equities, NYSE Chicago, and NYSE National late trading sessions will close at 5:00 p.m. Eastern Time.",
+        },
+    },
+    2027: {
+        "2027-11-26": {
+            date: "2027-11-26",
+            time: "13:00",
+            optionsTime: "13:15",
+            notes: "Market closes early on Friday, November 26, 2027 at 1:00 p.m. (1:15 p.m. for eligible options). NYSE American Equities, NYSE Arca Equities, NYSE National, and NYSE Texas late trading sessions will close at 5:00 p.m. Eastern Time.",
+        },
+    },
 };
 
 // market-time.ts
@@ -731,9 +827,15 @@ const marketEarlyCloses = {
  * Early extended market hours are 1:00pm-5:00pm on early close days
  */
 const MARKET_TIMES = {
-    TIMEZONE: 'America/New_York',
-    REGULAR: { START: { HOUR: 9, MINUTE: 30}, END: { HOUR: 16, MINUTE: 0} },
-    EXTENDED: { START: { HOUR: 4, MINUTE: 0}, END: { HOUR: 20, MINUTE: 0} },
+    TIMEZONE: "America/New_York",
+    REGULAR: {
+        START: { HOUR: 9, MINUTE: 30},
+        END: { HOUR: 16, MINUTE: 0},
+    },
+    EXTENDED: {
+        START: { HOUR: 4, MINUTE: 0},
+        END: { HOUR: 20, MINUTE: 0},
+    },
 };
 /**
  * Utility class for handling market time-related operations
@@ -746,7 +848,7 @@ class MarketTimeUtil {
      * @param {string} [timezone='America/New_York'] - The timezone to use for market time calculations
      * @param {IntradayReporting} [intradayReporting='market_hours'] - The intraday reporting mode
      */
-    constructor(timezone = MARKET_TIMES.TIMEZONE, intradayReporting = 'market_hours') {
+    constructor(timezone = MARKET_TIMES.TIMEZONE, intradayReporting = "market_hours") {
         this.validateTimezone(timezone);
         this.timezone = timezone;
         this.intradayReporting = intradayReporting;
@@ -765,25 +867,37 @@ class MarketTimeUtil {
             throw new Error(`Invalid timezone: ${timezone}`);
         }
     }
-    formatDate(date, outputFormat = 'iso') {
+    formatDate(date, outputFormat = "iso") {
         switch (outputFormat) {
-            case 'unix-seconds':
+            case "unix-seconds":
                 return Math.floor(date.getTime() / 1000);
-            case 'unix-ms':
+            case "unix-ms":
                 return date.getTime();
-            case 'iso':
+            case "iso":
             default:
                 // return with timezone offset
                 return formatInTimeZone(date, this.timezone, "yyyy-MM-dd'T'HH:mm:ssXXX");
         }
     }
-    isWeekend(date) {
-        const day = date.getDay();
+    /**
+     * Checks if a NY-zoned date falls on a weekend.
+     * Expects a date already converted to market timezone via toZonedTime.
+     * @param nyDate - Date in market timezone representation
+     * @returns true if the date is Saturday or Sunday
+     */
+    isWeekendZoned(nyDate) {
+        const day = nyDate.getDay();
         return day === 0 || day === 6;
     }
-    isHoliday(date) {
-        const formattedDate = format(date, 'yyyy-MM-dd');
-        const yearHolidays = marketHolidays[date.getFullYear()];
+    /**
+     * Checks if a NY-zoned date falls on a market holiday.
+     * Expects a date already converted to market timezone via toZonedTime.
+     * @param nyDate - Date in market timezone representation
+     * @returns true if the date is a holiday
+     */
+    isHolidayZoned(nyDate) {
+        const formattedDate = format(nyDate, "yyyy-MM-dd");
+        const yearHolidays = marketHolidays[nyDate.getFullYear()];
         for (const holiday in yearHolidays) {
             if (yearHolidays[holiday].date === formattedDate) {
                 return true;
@@ -791,50 +905,98 @@ class MarketTimeUtil {
         }
         return false;
     }
-    isEarlyCloseDay(date) {
-        const formattedDate = format(date, 'yyyy-MM-dd');
-        const yearEarlyCloses = marketEarlyCloses[date.getFullYear()];
+    /**
+     * Checks if a NY-zoned date is an early close day.
+     * Expects a date already converted to market timezone via toZonedTime.
+     * @param nyDate - Date in market timezone representation
+     * @returns true if the date is an early close day
+     */
+    isEarlyCloseDayZoned(nyDate) {
+        const formattedDate = format(nyDate, "yyyy-MM-dd");
+        const yearEarlyCloses = marketEarlyCloses[nyDate.getFullYear()];
         return yearEarlyCloses && yearEarlyCloses[formattedDate] !== undefined;
     }
     /**
-     * Get the early close time for a given date
-     * @param date - The date to get the early close time for
-     * @returns The early close time in minutes from midnight, or null if there is no early close
+     * Gets the early close time for a NY-zoned date.
+     * Expects a date already converted to market timezone via toZonedTime.
+     * @param nyDate - Date in market timezone representation
+     * @returns The early close time in minutes from midnight, or null if not an early close day
      */
-    getEarlyCloseTime(date) {
-        const formattedDate = format(date, 'yyyy-MM-dd');
-        const yearEarlyCloses = marketEarlyCloses[date.getFullYear()];
+    getEarlyCloseTimeZoned(nyDate) {
+        const formattedDate = format(nyDate, "yyyy-MM-dd");
+        const yearEarlyCloses = marketEarlyCloses[nyDate.getFullYear()];
         if (yearEarlyCloses && yearEarlyCloses[formattedDate]) {
-            const [hours, minutes] = yearEarlyCloses[formattedDate].time.split(':').map(Number);
+            const [hours, minutes] = yearEarlyCloses[formattedDate].time
+                .split(":")
+                .map(Number);
             return hours * 60 + minutes;
         }
         return null;
     }
     /**
-     * Check if a given date is a market day
-     * @param date - The date to check
+     * Checks if a NY-zoned date is a market day (not weekend, not holiday).
+     * Expects a date already converted to market timezone via toZonedTime.
+     * @param nyDate - Date in market timezone representation
+     * @returns true if the date is a market day
+     */
+    isMarketDayZoned(nyDate) {
+        return !this.isWeekendZoned(nyDate) && !this.isHolidayZoned(nyDate);
+    }
+    /**
+     * Check if a given date is an early close day.
+     * Handles timezone conversion from any input date.
+     * @param date - The date to check (any timezone)
+     * @returns true if the date is an early close day
+     */
+    isEarlyCloseDay(date) {
+        const nyDate = toZonedTime(date, this.timezone);
+        return this.isEarlyCloseDayZoned(nyDate);
+    }
+    /**
+     * Get the early close time for a given date.
+     * Handles timezone conversion from any input date.
+     * @param date - The date to check (any timezone)
+     * @returns The early close time in minutes from midnight, or null if there is no early close
+     */
+    getEarlyCloseTime(date) {
+        const nyDate = toZonedTime(date, this.timezone);
+        return this.getEarlyCloseTimeZoned(nyDate);
+    }
+    /**
+     * Check if a given date is a market day.
+     * Handles timezone conversion from any input date.
+     * @param date - The date to check (any timezone)
      * @returns true if the date is a market day, false otherwise
      */
     isMarketDay(date) {
-        const isWeekendDay = this.isWeekend(date);
-        const isHolidayDay = this.isHoliday(date);
-        const returner = !isWeekendDay && !isHolidayDay;
-        return returner;
+        const nyDate = toZonedTime(date, this.timezone);
+        return this.isMarketDayZoned(nyDate);
     }
     /**
-     * Check if a given date is within market hours
-     * @param date - The date to check
+     * Check if a given date is within market hours.
+     * Handles timezone conversion from any input date.
+     * @param date - The date to check (any timezone)
      * @returns true if the date is within market hours, false otherwise
      */
     isWithinMarketHours(date) {
-        // Check for holidays first
-        if (this.isHoliday(date)) {
+        const nyDate = toZonedTime(date, this.timezone);
+        return this.isWithinMarketHoursZoned(nyDate);
+    }
+    /**
+     * Check if a NY-zoned date is within market hours.
+     * Expects a date already converted to market timezone via toZonedTime.
+     * @param nyDate - Date in market timezone representation
+     * @returns true if the date is within market hours, false otherwise
+     */
+    isWithinMarketHoursZoned(nyDate) {
+        // Check for weekends and holidays first
+        if (this.isWeekendZoned(nyDate) || this.isHolidayZoned(nyDate)) {
             return false;
         }
-        const timeInMinutes = date.getHours() * 60 + date.getMinutes();
+        const timeInMinutes = nyDate.getHours() * 60 + nyDate.getMinutes();
         // Check for early closure
-        if (this.isEarlyCloseDay(date)) {
-            const earlyCloseMinutes = this.getEarlyCloseTime(date);
+        if (this.isEarlyCloseDayZoned(nyDate)) {
+            const earlyCloseMinutes = this.getEarlyCloseTimeZoned(nyDate);
             if (earlyCloseMinutes !== null && timeInMinutes > earlyCloseMinutes) {
                 return false;
             }
@@ -842,38 +1004,50 @@ class MarketTimeUtil {
         // Regular market hours logic
         let returner;
         switch (this.intradayReporting) {
-            case 'extended_hours': {
-                const extendedStartMinutes = MARKET_TIMES.EXTENDED.START.HOUR * 60 + MARKET_TIMES.EXTENDED.START.MINUTE;
-                const extendedEndMinutes = MARKET_TIMES.EXTENDED.END.HOUR * 60 + MARKET_TIMES.EXTENDED.END.MINUTE;
+            case "extended_hours": {
+                const extendedStartMinutes = MARKET_TIMES.EXTENDED.START.HOUR * 60 +
+                    MARKET_TIMES.EXTENDED.START.MINUTE;
+                const extendedEndMinutes = MARKET_TIMES.EXTENDED.END.HOUR * 60 +
+                    MARKET_TIMES.EXTENDED.END.MINUTE;
                 // Comprehensive handling of times crossing midnight
-                const adjustedDate = timeInMinutes < extendedStartMinutes ? sub(date, { days: 1 }) : date;
-                const adjustedTimeInMinutes = adjustedDate.getHours() * 60 + adjustedDate.getMinutes();
-                returner = adjustedTimeInMinutes >= extendedStartMinutes && adjustedTimeInMinutes <= extendedEndMinutes;
+                const adjustedNyDate = timeInMinutes < extendedStartMinutes
+                    ? sub(nyDate, { days: 1 })
+                    : nyDate;
+                const adjustedTimeInMinutes = adjustedNyDate.getHours() * 60 + adjustedNyDate.getMinutes();
+                returner =
+                    adjustedTimeInMinutes >= extendedStartMinutes &&
+                        adjustedTimeInMinutes <= extendedEndMinutes;
                 break;
             }
-            case 'continuous':
+            case "continuous":
                 returner = true;
                 break;
             default: {
                 // market_hours
-                const regularStartMinutes = MARKET_TIMES.REGULAR.START.HOUR * 60 + MARKET_TIMES.REGULAR.START.MINUTE;
+                const regularStartMinutes = MARKET_TIMES.REGULAR.START.HOUR * 60 +
+                    MARKET_TIMES.REGULAR.START.MINUTE;
                 const regularEndMinutes = MARKET_TIMES.REGULAR.END.HOUR * 60 + MARKET_TIMES.REGULAR.END.MINUTE;
-                returner = timeInMinutes >= regularStartMinutes && timeInMinutes <= regularEndMinutes;
+                returner =
+                    timeInMinutes >= regularStartMinutes &&
+                        timeInMinutes <= regularEndMinutes;
                 break;
             }
         }
         return returner;
     }
     /**
-     * Check if a given date is before market hours
-     * @param date - The date to check
+     * Check if a NY-zoned date is before market hours.
+     * Expects a date already converted to market timezone via toZonedTime.
+     * @param nyDate - Date in market timezone representation
      * @returns true if the date is before market hours, false otherwise
      */
-    isBeforeMarketHours(date) {
-        const timeInMinutes = date.getHours() * 60 + date.getMinutes();
-        const startMinutes = this.intradayReporting === 'extended_hours'
-            ? MARKET_TIMES.EXTENDED.START.HOUR * 60 + MARKET_TIMES.EXTENDED.START.MINUTE
-            : MARKET_TIMES.REGULAR.START.HOUR * 60 + MARKET_TIMES.REGULAR.START.MINUTE;
+    isBeforeMarketHoursZoned(nyDate) {
+        const timeInMinutes = nyDate.getHours() * 60 + nyDate.getMinutes();
+        const startMinutes = this.intradayReporting === "extended_hours"
+            ? MARKET_TIMES.EXTENDED.START.HOUR * 60 +
+                MARKET_TIMES.EXTENDED.START.MINUTE
+            : MARKET_TIMES.REGULAR.START.HOUR * 60 +
+                MARKET_TIMES.REGULAR.START.MINUTE;
         return timeInMinutes < startMinutes;
     }
     /**
@@ -883,7 +1057,7 @@ class MarketTimeUtil {
      */
     getLastTradingDate(currentDate = new Date()) {
         const nowET = toZonedTime(currentDate, this.timezone);
-        const isMarketDayToday = this.isMarketDay(nowET);
+        const isMarketDayToday = this.isMarketDayZoned(nowET);
         const currentMinutes = nowET.getHours() * 60 + nowET.getMinutes();
         const marketOpenMinutes = MARKET_TIMES.REGULAR.START.HOUR * 60 + MARKET_TIMES.REGULAR.START.MINUTE;
         if (isMarketDayToday && currentMinutes >= marketOpenMinutes) {
@@ -893,7 +1067,7 @@ class MarketTimeUtil {
         else {
             // Before market open, or not a market day, return previous trading day
             let lastTradingDate = sub(nowET, { days: 1 });
-            while (!this.isMarketDay(lastTradingDate)) {
+            while (!this.isMarketDayZoned(lastTradingDate)) {
                 lastTradingDate = sub(lastTradingDate, { days: 1 });
             }
             return lastTradingDate;
@@ -901,7 +1075,7 @@ class MarketTimeUtil {
     }
     getLastMarketDay(date) {
         let currentDate = sub(date, { days: 1 });
-        while (!this.isMarketDay(currentDate)) {
+        while (!this.isMarketDayZoned(currentDate)) {
             currentDate = sub(currentDate, { days: 1 });
         }
         return currentDate;
@@ -910,7 +1084,7 @@ class MarketTimeUtil {
         const nowET = toZonedTime(currentDate, this.timezone);
         // If today is a market day and we're after extended hours close
         // then return today since it's a completed trading day
-        if (this.isMarketDay(nowET)) {
+        if (this.isMarketDayZoned(nowET)) {
             const timeInMinutes = nowET.getHours() * 60 + nowET.getMinutes();
             const extendedEndMinutes = MARKET_TIMES.EXTENDED.END.HOUR * 60 + MARKET_TIMES.EXTENDED.END.MINUTE;
             // Check if we're after market close (including extended hours)
@@ -934,18 +1108,33 @@ class MarketTimeUtil {
      * @property {string} yyyymmdd - The date in YYYY-MM-DD format
      * @property {string} dateISOString - Full ISO date string
      */
-    getNextMarketDay(date) {
-        let currentDate = add(date, { days: 1 });
-        while (!this.isMarketDay(currentDate)) {
+    /**
+     * Gets the next market day from a date already in market timezone.
+     * @param nyDate - Date in market timezone representation
+     * @returns The next market day in market timezone representation
+     */
+    getNextMarketDayZoned(nyDate) {
+        let currentDate = add(nyDate, { days: 1 });
+        while (!this.isMarketDayZoned(currentDate)) {
             currentDate = add(currentDate, { days: 1 });
         }
         return currentDate;
     }
+    /**
+     * Gets the next market day from a reference date.
+     * Handles timezone conversion from any input date.
+     * @param date - The reference date (any timezone)
+     * @returns The next market day as a Date (note: internally represented in market timezone)
+     */
+    getNextMarketDay(date) {
+        const nyDate = toZonedTime(date, this.timezone);
+        return this.getNextMarketDayZoned(nyDate);
+    }
     getDayBoundaries(date) {
         let start;
         let end;
         switch (this.intradayReporting) {
-            case 'extended_hours': {
+            case "extended_hours": {
                 start = set(date, {
                     hours: MARKET_TIMES.EXTENDED.START.HOUR,
                     minutes: MARKET_TIMES.EXTENDED.START.MINUTE,
@@ -960,7 +1149,7 @@ class MarketTimeUtil {
                 });
                 break;
             }
-            case 'continuous': {
+            case "continuous": {
                 start = startOfDay(date);
                 end = endOfDay(date);
                 break;
@@ -973,9 +1162,9 @@ class MarketTimeUtil {
                     seconds: 0,
                     milliseconds: 0,
                 });
-                // Check for early close
-                if (this.isEarlyCloseDay(date)) {
-                    const earlyCloseMinutes = this.getEarlyCloseTime(date);
+                // Check for early close (date is already zoned)
+                if (this.isEarlyCloseDayZoned(date)) {
+                    const earlyCloseMinutes = this.getEarlyCloseTimeZoned(date);
                     if (earlyCloseMinutes !== null) {
                         const earlyCloseHours = Math.floor(earlyCloseMinutes / 60);
                         const earlyCloseMinutesRemainder = earlyCloseMinutes % 60;
@@ -1002,44 +1191,44 @@ class MarketTimeUtil {
     calculatePeriodStartDate(endDate, period) {
         let startDate;
         switch (period) {
-            case 'YTD':
+            case "YTD":
                 startDate = set(endDate, { month: 0, date: 1 });
                 break;
-            case '1D':
+            case "1D":
                 startDate = this.getLastMarketDay(endDate);
                 break;
-            case '3D':
+            case "3D":
                 startDate = sub(endDate, { days: 3 });
                 break;
-            case '1W':
+            case "1W":
                 startDate = sub(endDate, { weeks: 1 });
                 break;
-            case '2W':
+            case "2W":
                 startDate = sub(endDate, { weeks: 2 });
                 break;
-            case '1M':
+            case "1M":
                 startDate = sub(endDate, { months: 1 });
                 break;
-            case '3M':
+            case "3M":
                 startDate = sub(endDate, { months: 3 });
                 break;
-            case '6M':
+            case "6M":
                 startDate = sub(endDate, { months: 6 });
                 break;
-            case '1Y':
+            case "1Y":
                 startDate = sub(endDate, { years: 1 });
                 break;
             default:
                 throw new Error(`Invalid period: ${period}`);
         }
-        while (!this.isMarketDay(startDate)) {
-            startDate = this.getNextMarketDay(startDate);
+        while (!this.isMarketDayZoned(startDate)) {
+            startDate = this.getNextMarketDayZoned(startDate);
         }
         return startDate;
     }
-    getMarketTimePeriod({ period, end = new Date(), intraday_reporting, outputFormat = 'iso', }) {
+    getMarketTimePeriod({ period, end = new Date(), intraday_reporting, outputFormat = "iso", }) {
         if (!period) {
-            throw new Error('Period is required');
+            throw new Error("Period is required");
         }
         if (intraday_reporting) {
             this.intradayReporting = intraday_reporting;
@@ -1048,9 +1237,9 @@ class MarketTimeUtil {
         const zonedEndDate = toZonedTime(end, this.timezone);
         let startDate;
         let endDate;
-        const isCurrentMarketDay = this.isMarketDay(zonedEndDate);
-        const isWithinHours = this.isWithinMarketHours(zonedEndDate);
-        const isBeforeHours = this.isBeforeMarketHours(zonedEndDate);
+        const isCurrentMarketDay = this.isMarketDayZoned(zonedEndDate);
+        const isWithinHours = this.isWithinMarketHoursZoned(zonedEndDate);
+        const isBeforeHours = this.isBeforeMarketHoursZoned(zonedEndDate);
         // First determine the end date based on current market conditions
         if (isCurrentMarketDay) {
             if (isBeforeHours) {
@@ -1084,7 +1273,7 @@ class MarketTimeUtil {
         const utcEnd = fromZonedTime(endDate, this.timezone);
         // Ensure start is not after end
         if (isBefore(utcEnd, utcStart)) {
-            throw new Error('Start date cannot be after end date');
+            throw new Error("Start date cannot be after end date");
         }
         return {
             start: this.formatDate(utcStart, outputFormat),
@@ -1095,7 +1284,7 @@ class MarketTimeUtil {
         const { date = new Date() } = options;
         const zonedDate = toZonedTime(date, this.timezone);
         // Check if market is closed for the day
-        if (this.isWeekend(zonedDate) || this.isHoliday(zonedDate)) {
+        if (this.isWeekendZoned(zonedDate) || this.isHolidayZoned(zonedDate)) {
             return {
                 marketOpen: false,
                 open: null,
@@ -1109,10 +1298,10 @@ class MarketTimeUtil {
         let regularCloseTime = MARKET_TIMES.REGULAR.END;
         const extendedOpenTime = MARKET_TIMES.EXTENDED.START;
         let extendedCloseTime = MARKET_TIMES.EXTENDED.END;
-        // Check for early close
-        const isEarlyClose = this.isEarlyCloseDay(zonedDate);
+        // Check for early close (zonedDate is already in market timezone)
+        const isEarlyClose = this.isEarlyCloseDayZoned(zonedDate);
         if (isEarlyClose) {
-            const earlyCloseMinutes = this.getEarlyCloseTime(zonedDate);
+            const earlyCloseMinutes = this.getEarlyCloseTimeZoned(zonedDate);
             if (earlyCloseMinutes !== null) {
                 // For regular hours, use the early close time
                 regularCloseTime = {
@@ -1128,10 +1317,22 @@ class MarketTimeUtil {
                 };
             }
         }
-        const open = fromZonedTime(set(dayStart, { hours: regularOpenTime.HOUR, minutes: regularOpenTime.MINUTE }), this.timezone);
-        const close = fromZonedTime(set(dayStart, { hours: regularCloseTime.HOUR, minutes: regularCloseTime.MINUTE }), this.timezone);
-        const openExt = fromZonedTime(set(dayStart, { hours: extendedOpenTime.HOUR, minutes: extendedOpenTime.MINUTE }), this.timezone);
-        const closeExt = fromZonedTime(set(dayStart, { hours: extendedCloseTime.HOUR, minutes: extendedCloseTime.MINUTE }), this.timezone);
+        const open = fromZonedTime(set(dayStart, {
+            hours: regularOpenTime.HOUR,
+            minutes: regularOpenTime.MINUTE,
+        }), this.timezone);
+        const close = fromZonedTime(set(dayStart, {
+            hours: regularCloseTime.HOUR,
+            minutes: regularCloseTime.MINUTE,
+        }), this.timezone);
+        const openExt = fromZonedTime(set(dayStart, {
+            hours: extendedOpenTime.HOUR,
+            minutes: extendedOpenTime.MINUTE,
+        }), this.timezone);
+        const closeExt = fromZonedTime(set(dayStart, {
+            hours: extendedCloseTime.HOUR,
+            minutes: extendedCloseTime.MINUTE,
+        }), this.timezone);
         return {
             marketOpen: true,
             open,
@@ -1154,7 +1355,7 @@ function getLastFullTradingDate(currentDate = new Date()) {
     // Format the date in NY timezone to ensure consistency
     return {
         date,
-        YYYYMMDD: formatInTimeZone(date, MARKET_TIMES.TIMEZONE, 'yyyy-MM-dd'),
+        YYYYMMDD: formatInTimeZone(date, MARKET_TIMES.TIMEZONE, "yyyy-MM-dd"),
     };
 }
 
@@ -6128,13 +6329,82 @@ function requireWebsocketServer () {
 
 requireWebsocketServer();
 
-const log$1 = (message, options = { type: 'info' }) => {
-    log$2(message, { ...options, source: 'AlpacaMarketDataAPI' });
+/**
+ * API credential validation utilities
+ * Provides fast, synchronous validation of API credentials before making requests
+ */
+/**
+ * Validates Alpaca API credentials
+ * @param auth - Authentication object containing API key and secret
+ * @param options - Validation options
+ * @param options.throwOnMissing - If false, missing credentials will log a warning instead of throwing (default: true)
+ * @throws {Error} If credentials are invalid (when throwOnMissing is true)
+ * @returns {boolean} True if credentials are valid, false if missing (when throwOnMissing is false)
+ */
+function validateAlpacaCredentials(auth, options = { throwOnMissing: true }) {
+    const { throwOnMissing = true } = options;
+    // Check for missing or empty API key
+    if (!auth.apiKey ||
+        typeof auth.apiKey !== "string" ||
+        auth.apiKey.trim().length === 0) {
+        if (throwOnMissing) {
+            throw new Error("Invalid Alpaca API key: must be a non-empty string");
+        }
+        console.warn("[AlpacaAPI] API key not configured. Market data features will be unavailable.");
+        return false;
+    }
+    // Check for missing or empty API secret
+    if (!auth.apiSecret ||
+        typeof auth.apiSecret !== "string" ||
+        auth.apiSecret.trim().length === 0) {
+        if (throwOnMissing) {
+            throw new Error("Invalid Alpaca API secret: must be a non-empty string");
+        }
+        console.warn("[AlpacaAPI] API secret not configured. Market data features will be unavailable.");
+        return false;
+    }
+    // Alpaca keys are typically 20+ characters
+    if (auth.apiKey.length < 10) {
+        if (throwOnMissing) {
+            throw new Error("Alpaca API key appears to be too short");
+        }
+        console.warn("[AlpacaAPI] API key appears to be too short.");
+        return false;
+    }
+    return true;
+}
+
+/**
+ * HTTP request timeout utilities
+ * Provides configurable timeout handling for external API calls
+ */
+/**
+ * Default timeout values for different external APIs (in milliseconds)
+ * Can be overridden via environment variables
+ */
+const DEFAULT_TIMEOUTS = {
+    ALPACA_API: parseInt(process.env.ALPACA_API_TIMEOUT || "30000", 10),
+    POLYGON_API: parseInt(process.env.POLYGON_API_TIMEOUT || "30000", 10),
+    ALPHA_VANTAGE: parseInt(process.env.ALPHA_VANTAGE_API_TIMEOUT || "30000", 10),
+    GENERAL: parseInt(process.env.HTTP_TIMEOUT || "30000", 10),
+};
+/**
+ * Creates an AbortSignal that times out after the specified duration
+ * Compatible with fetch API
+ * @param ms - Timeout duration in milliseconds
+ * @returns AbortSignal that will abort after the specified duration
+ */
+function createTimeoutSignal(ms) {
+    return AbortSignal.timeout(ms);
+}
+
+const log$1 = (message, options = { type: "info" }) => {
+    log$2(message, { ...options, source: "AlpacaMarketDataAPI" });
 };
 // Default settings for market data API
-const DEFAULT_ADJUSTMENT = 'all';
-const DEFAULT_FEED = 'sip';
-const DEFAULT_CURRENCY = 'USD';
+const DEFAULT_ADJUSTMENT = "all";
+const DEFAULT_FEED = "sip";
+const DEFAULT_CURRENCY = "USD";
 /**
  * Singleton class for interacting with Alpaca Market Data API
  * Provides methods for fetching historical bars, latest bars, last trades, latest trades, latest quotes, and latest quote for a single symbol
@@ -6145,56 +6415,84 @@ class AlpacaMarketDataAPI extends EventEmitter {
     dataURL;
     apiURL;
     v1beta1url;
-    stockStreamUrl = 'wss://stream.data.alpaca.markets/v2/sip'; // production values
-    optionStreamUrl = 'wss://stream.data.alpaca.markets/v1beta3/options'; // production values
-    cryptoStreamUrl = 'wss://stream.data.alpaca.markets/v1beta3/crypto/us'; // production values
+    /** Whether API credentials are valid and available. False during build time when env vars are missing. */
+    credentialsValid = false;
+    stockStreamUrl = getStockStreamUrl("PRODUCTION"); // production values
+    optionStreamUrl = getOptionsStreamUrl("PRODUCTION"); // production values
+    cryptoStreamUrl = getCryptoStreamUrl("PRODUCTION"); // production values
     stockWs = null;
     optionWs = null;
     cryptoWs = null;
-    stockSubscriptions = { trades: [], quotes: [], bars: [] };
-    optionSubscriptions = { trades: [], quotes: [], bars: [] };
-    cryptoSubscriptions = { trades: [], quotes: [], bars: [] };
-    setMode(mode = 'production') {
-        if (mode === 'sandbox') { // sandbox mode
-            this.stockStreamUrl = 'wss://stream.data.sandbox.alpaca.markets/v2/sip';
-            this.optionStreamUrl = 'wss://stream.data.sandbox.alpaca.markets/v1beta3/options';
-            this.cryptoStreamUrl = 'wss://stream.data.sandbox.alpaca.markets/v1beta3/crypto/us';
+    stockSubscriptions = {
+        trades: [],
+        quotes: [],
+        bars: [],
+    };
+    optionSubscriptions = {
+        trades: [],
+        quotes: [],
+        bars: [],
+    };
+    cryptoSubscriptions = {
+        trades: [],
+        quotes: [],
+        bars: [],
+    };
+    setMode(mode = "production") {
+        if (mode === "sandbox") {
+            // sandbox mode
+            this.stockStreamUrl = WEBSOCKET_STREAMS.STOCKS.PRODUCTION; // sandbox uses production for stocks
+            this.optionStreamUrl = getOptionsStreamUrl("SANDBOX");
+            this.cryptoStreamUrl = getCryptoStreamUrl("SANDBOX");
         }
-        else if (mode === 'test') { // test mode, can only use ticker FAKEPACA
-            this.stockStreamUrl = 'wss://stream.data.alpaca.markets/v2/test';
-            this.optionStreamUrl = 'wss://stream.data.alpaca.markets/v1beta3/options'; // there's no test mode for options
-            this.cryptoStreamUrl = 'wss://stream.data.alpaca.markets/v1beta3/crypto/us'; // there's no test mode for crypto
+        else if (mode === "test") {
+            // test mode, can only use ticker FAKEPACA
+            this.stockStreamUrl = getStockStreamUrl("TEST");
+            this.optionStreamUrl = getOptionsStreamUrl("PRODUCTION"); // there's no test mode for options
+            this.cryptoStreamUrl = getCryptoStreamUrl("PRODUCTION"); // there's no test mode for crypto
         }
-        else { // production
-            this.stockStreamUrl = 'wss://stream.data.alpaca.markets/v2/sip';
-            this.optionStreamUrl = 'wss://stream.data.alpaca.markets/v1beta3/options';
-            this.cryptoStreamUrl = 'wss://stream.data.alpaca.markets/v1beta3/crypto/us';
+        else {
+            // production
+            this.stockStreamUrl = getStockStreamUrl("PRODUCTION");
+            this.optionStreamUrl = getOptionsStreamUrl("PRODUCTION");
+            this.cryptoStreamUrl = getCryptoStreamUrl("PRODUCTION");
         }
     }
     getMode() {
-        if (this.stockStreamUrl.includes('sandbox')) {
-            return 'sandbox';
+        if (this.stockStreamUrl.includes("sandbox")) {
+            return "sandbox";
         }
-        else if (this.stockStreamUrl.includes('test')) {
-            return 'test';
+        else if (this.stockStreamUrl.includes("test")) {
+            return "test";
         }
         else {
-            return 'production';
+            return "production";
         }
     }
     constructor() {
         super();
-        this.dataURL = 'https://data.alpaca.markets/v2';
+        // Validate credentials from environment variables before initializing
+        // Use throwOnMissing: false to allow initialization during build time
+        // when env vars are not available. Features will be unavailable until
+        // credentials are provided at runtime.
+        const apiKey = process.env.ALPACA_API_KEY || "";
+        const apiSecret = process.env.ALPACA_SECRET_KEY || "";
+        this.credentialsValid = validateAlpacaCredentials({
+            apiKey,
+            apiSecret,
+            isPaper: process.env.ALPACA_ACCOUNT_TYPE === "PAPER",
+        }, { throwOnMissing: false });
+        this.dataURL = MARKET_DATA_API.STOCKS;
         this.apiURL =
-            process.env.ALPACA_ACCOUNT_TYPE === 'PAPER'
-                ? 'https://paper-api.alpaca.markets/v2'
-                : 'https://api.alpaca.markets/v2'; // used by some, e.g. getAssets
-        this.v1beta1url = 'https://data.alpaca.markets/v1beta1'; // used for options endpoints
-        this.setMode('production'); // sets stockStreamUrl and optionStreamUrl
+            process.env.ALPACA_ACCOUNT_TYPE === "PAPER"
+                ? getTradingApiUrl("PAPER")
+                : getTradingApiUrl("LIVE"); // used by some, e.g. getAssets
+        this.v1beta1url = MARKET_DATA_API.OPTIONS; // used for options endpoints
+        this.setMode("production"); // sets stockStreamUrl and optionStreamUrl
         this.headers = {
-            'APCA-API-KEY-ID': process.env.ALPACA_API_KEY,
-            'APCA-API-SECRET-KEY': process.env.ALPACA_SECRET_KEY,
-            'Content-Type': 'application/json',
+            "APCA-API-KEY-ID": apiKey,
+            "APCA-API-SECRET-KEY": apiSecret,
+            "Content-Type": "application/json",
         };
     }
     static getInstance() {
@@ -6211,73 +6509,75 @@ class AlpacaMarketDataAPI extends EventEmitter {
     }
     connect(streamType) {
         let url;
-        if (streamType === 'stock') {
+        if (streamType === "stock") {
             url = this.stockStreamUrl;
         }
-        else if (streamType === 'option') {
+        else if (streamType === "option") {
             url = this.optionStreamUrl;
         }
         else {
             url = this.cryptoStreamUrl;
         }
         const ws = new WebSocket(url);
-        if (streamType === 'stock') {
+        if (streamType === "stock") {
             this.stockWs = ws;
         }
-        else if (streamType === 'option') {
+        else if (streamType === "option") {
             this.optionWs = ws;
         }
         else {
             this.cryptoWs = ws;
         }
-        ws.on('open', () => {
-            log$1(`${streamType} stream connected`, { type: 'info' });
+        ws.on("open", () => {
+            log$1(`${streamType} stream connected`, { type: "info" });
             const authMessage = {
-                action: 'auth',
+                action: "auth",
                 key: process.env.ALPACA_API_KEY,
                 secret: process.env.ALPACA_SECRET_KEY,
             };
             ws.send(JSON.stringify(authMessage));
         });
-        ws.on('message', (data) => {
+        ws.on("message", (data) => {
             const rawData = data.toString();
             let messages;
             try {
                 messages = JSON.parse(rawData);
             }
             catch (e) {
-                log$1(`${streamType} stream received invalid JSON: ${rawData.substring(0, 200)}`, { type: 'error' });
+                log$1(`${streamType} stream received invalid JSON: ${rawData.substring(0, 200)}`, { type: "error" });
                 return;
             }
             for (const message of messages) {
-                if (message.T === 'success' && message.msg === 'authenticated') {
-                    log$1(`${streamType} stream authenticated`, { type: 'info' });
+                if (message.T === "success" && message.msg === "authenticated") {
+                    log$1(`${streamType} stream authenticated`, { type: "info" });
                     this.sendSubscription(streamType);
                 }
-                else if (message.T === 'success' && message.msg === 'connected') {
-                    log$1(`${streamType} stream connected message received`, { type: 'debug' });
+                else if (message.T === "success" && message.msg === "connected") {
+                    log$1(`${streamType} stream connected message received`, {
+                        type: "debug",
+                    });
                 }
-                else if (message.T === 'subscription') {
-                    log$1(`${streamType} subscription confirmed: trades=${message.trades?.length || 0}, quotes=${message.quotes?.length || 0}, bars=${message.bars?.length || 0}`, { type: 'info' });
+                else if (message.T === "subscription") {
+                    log$1(`${streamType} subscription confirmed: trades=${message.trades?.length || 0}, quotes=${message.quotes?.length || 0}, bars=${message.bars?.length || 0}`, { type: "info" });
                 }
-                else if (message.T === 'error') {
-                    log$1(`${streamType} stream error: ${message.msg} (code: ${message.code}, raw: ${JSON.stringify(message)})`, { type: 'error' });
+                else if (message.T === "error") {
+                    log$1(`${streamType} stream error: ${message.msg} (code: ${message.code}, raw: ${JSON.stringify(message)})`, { type: "error" });
                 }
                 else if (message.S) {
                     super.emit(`${streamType}-${message.T}`, message);
                     super.emit(`${streamType}-data`, message);
                 }
                 else {
-                    log$1(`${streamType} received unknown message type: ${JSON.stringify(message)}`, { type: 'debug' });
+                    log$1(`${streamType} received unknown message type: ${JSON.stringify(message)}`, { type: "debug" });
                 }
             }
         });
-        ws.on('close', () => {
-            log$1(`${streamType} stream disconnected`, { type: 'warn' });
-            if (streamType === 'stock') {
+        ws.on("close", () => {
+            log$1(`${streamType} stream disconnected`, { type: "warn" });
+            if (streamType === "stock") {
                 this.stockWs = null;
             }
-            else if (streamType === 'option') {
+            else if (streamType === "option") {
                 this.optionWs = null;
             }
             else {
@@ -6285,18 +6585,18 @@ class AlpacaMarketDataAPI extends EventEmitter {
             }
             // Optional: implement reconnect logic
         });
-        ws.on('error', (error) => {
-            log$1(`${streamType} stream error: ${error.message}`, { type: 'error' });
+        ws.on("error", (error) => {
+            log$1(`${streamType} stream error: ${error.message}`, { type: "error" });
         });
     }
     sendSubscription(streamType) {
         let ws;
         let subscriptions;
-        if (streamType === 'stock') {
+        if (streamType === "stock") {
             ws = this.stockWs;
             subscriptions = this.stockSubscriptions;
         }
-        else if (streamType === 'option') {
+        else if (streamType === "option") {
             ws = this.optionWs;
             subscriptions = this.optionSubscriptions;
         }
@@ -6305,7 +6605,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
             subscriptions = this.cryptoSubscriptions;
         }
         log$1(`sendSubscription called for ${streamType} (wsReady=${ws?.readyState === WebSocket.OPEN}, trades=${subscriptions.trades?.length || 0}, quotes=${subscriptions.quotes?.length || 0}, bars=${subscriptions.bars?.length || 0})`, {
-            type: 'debug',
+            type: "debug",
         });
         if (ws && ws.readyState === WebSocket.OPEN) {
             const subMessagePayload = {};
@@ -6320,34 +6620,40 @@ class AlpacaMarketDataAPI extends EventEmitter {
             }
             if (Object.keys(subMessagePayload).length > 0) {
                 const subMessage = {
-                    action: 'subscribe',
+                    action: "subscribe",
                     ...subMessagePayload,
                 };
                 const messageJson = JSON.stringify(subMessage);
-                log$1(`Sending ${streamType} subscription: ${messageJson}`, { type: 'info' });
+                log$1(`Sending ${streamType} subscription: ${messageJson}`, {
+                    type: "info",
+                });
                 ws.send(messageJson);
             }
             else {
-                log$1(`No ${streamType} subscriptions to send (all arrays empty)`, { type: 'debug' });
+                log$1(`No ${streamType} subscriptions to send (all arrays empty)`, {
+                    type: "debug",
+                });
             }
         }
         else {
-            log$1(`Cannot send ${streamType} subscription: WebSocket not ready`, { type: 'warn' });
+            log$1(`Cannot send ${streamType} subscription: WebSocket not ready`, {
+                type: "warn",
+            });
         }
     }
     connectStockStream() {
         if (!this.stockWs) {
-            this.connect('stock');
+            this.connect("stock");
         }
     }
     connectOptionStream() {
         if (!this.optionWs) {
-            this.connect('option');
+            this.connect("option");
         }
     }
     connectCryptoStream() {
         if (!this.cryptoWs) {
-            this.connect('crypto');
+            this.connect("crypto");
         }
     }
     disconnectStockStream() {
@@ -6371,22 +6677,22 @@ class AlpacaMarketDataAPI extends EventEmitter {
      * @returns True if the stream is connected
      */
     isStreamConnected(streamType) {
-        if (streamType === 'stock') {
-            return this.stockWs !== null && this.stockWs.readyState === WebSocket.OPEN;
+        if (streamType === "stock") {
+            return (this.stockWs !== null && this.stockWs.readyState === WebSocket.OPEN);
         }
-        else if (streamType === 'option') {
-            return this.optionWs !== null && this.optionWs.readyState === WebSocket.OPEN;
+        else if (streamType === "option") {
+            return (this.optionWs !== null && this.optionWs.readyState === WebSocket.OPEN);
         }
         else {
-            return this.cryptoWs !== null && this.cryptoWs.readyState === WebSocket.OPEN;
+            return (this.cryptoWs !== null && this.cryptoWs.readyState === WebSocket.OPEN);
         }
     }
     subscribe(streamType, subscriptions) {
         let currentSubscriptions;
-        if (streamType === 'stock') {
+        if (streamType === "stock") {
             currentSubscriptions = this.stockSubscriptions;
         }
-        else if (streamType === 'option') {
+        else if (streamType === "option") {
             currentSubscriptions = this.optionSubscriptions;
         }
         else {
@@ -6394,17 +6700,19 @@ class AlpacaMarketDataAPI extends EventEmitter {
         }
         Object.entries(subscriptions).forEach(([key, value]) => {
             if (value) {
-                currentSubscriptions[key] = [...new Set([...(currentSubscriptions[key] || []), ...value])];
+                currentSubscriptions[key] = [
+                    ...new Set([...(currentSubscriptions[key] || []), ...value]),
+                ];
             }
         });
         this.sendSubscription(streamType);
     }
     unsubscribe(streamType, subscriptions) {
         let currentSubscriptions;
-        if (streamType === 'stock') {
+        if (streamType === "stock") {
             currentSubscriptions = this.stockSubscriptions;
         }
-        else if (streamType === 'option') {
+        else if (streamType === "option") {
             currentSubscriptions = this.optionSubscriptions;
         }
         else {
@@ -6412,18 +6720,18 @@ class AlpacaMarketDataAPI extends EventEmitter {
         }
         Object.entries(subscriptions).forEach(([key, value]) => {
             if (value) {
-                currentSubscriptions[key] = (currentSubscriptions[key] || []).filter(s => !value.includes(s));
+                currentSubscriptions[key] = (currentSubscriptions[key] || []).filter((s) => !value.includes(s));
             }
         });
         const unsubMessage = {
-            action: 'unsubscribe',
+            action: "unsubscribe",
             ...subscriptions,
         };
         let ws;
-        if (streamType === 'stock') {
+        if (streamType === "stock") {
             ws = this.stockWs;
         }
-        else if (streamType === 'option') {
+        else if (streamType === "option") {
             ws = this.optionWs;
         }
         else {
@@ -6433,16 +6741,20 @@ class AlpacaMarketDataAPI extends EventEmitter {
             ws.send(JSON.stringify(unsubMessage));
         }
     }
-    async makeRequest(endpoint, method = 'GET', params, baseUrlName = 'data') {
-        const baseUrl = baseUrlName === 'data' ? this.dataURL : baseUrlName === 'api' ? this.apiURL : this.v1beta1url;
+    async makeRequest(endpoint, method = "GET", params, baseUrlName = "data") {
+        const baseUrl = baseUrlName === "data"
+            ? this.dataURL
+            : baseUrlName === "api"
+                ? this.apiURL
+                : this.v1beta1url;
         const url = new URL(`${baseUrl}${endpoint}`);
         try {
             if (params) {
                 Object.entries(params).forEach(([key, value]) => {
                     if (Array.isArray(value)) {
-                        url.searchParams.append(key, value.join(','));
+                        url.searchParams.append(key, value.join(","));
                     }
-                    else if (value !== undefined) {
+                    else if (value !== undefined && value !== null) {
                         url.searchParams.append(key, value.toString());
                     }
                 });
@@ -6450,10 +6762,13 @@ class AlpacaMarketDataAPI extends EventEmitter {
             const response = await fetch(url.toString(), {
                 method,
                 headers: this.headers,
+                signal: createTimeoutSignal(DEFAULT_TIMEOUTS.ALPACA_API),
             });
             if (!response.ok) {
                 const errorText = await response.text();
-                log$1(`Market Data API error (${response.status}): ${errorText}`, { type: 'error' });
+                log$1(`Market Data API error (${response.status}): ${errorText}`, {
+                    type: "error",
+                });
                 throw new Error(`Market Data API error (${response.status}): ${errorText}`);
             }
             const data = await response.json();
@@ -6461,9 +6776,9 @@ class AlpacaMarketDataAPI extends EventEmitter {
         }
         catch (err) {
             const error = err;
-            log$1(`Error in makeRequest: ${error.message}. Endpoint: ${endpoint}. Url: ${url.toString()}`, { type: 'error' });
+            log$1(`Error in makeRequest: ${error.message}. Endpoint: ${endpoint}. Url: ${url.toString()}`, { type: "error" });
             if (error instanceof TypeError) {
-                log$1(`Network error details: ${error.stack}`, { type: 'error' });
+                log$1(`Network error details: ${error.stack}`, { type: "error" });
             }
             throw error;
         }
@@ -6476,19 +6791,19 @@ class AlpacaMarketDataAPI extends EventEmitter {
      */
     async getHistoricalBars(params) {
         const symbols = params.symbols;
-        const symbolsStr = symbols.join(',');
+        const symbolsStr = symbols.join(",");
         let allBars = {};
         let pageToken = null;
         let hasMorePages = true;
         let totalBarsCount = 0;
         let pageCount = 0;
-        let currency = '';
+        let currency = "";
         // Initialize bar arrays for each symbol
-        symbols.forEach(symbol => {
+        symbols.forEach((symbol) => {
             allBars[symbol] = [];
         });
-        log$1(`Starting historical bars fetch for ${symbolsStr} (${params.timeframe}, ${params.start || 'no start'} to ${params.end || 'no end'})`, {
-            type: 'info'
+        log$1(`Starting historical bars fetch for ${symbolsStr} (${params.timeframe}, ${params.start || "no start"} to ${params.end || "no end"})`, {
+            type: "info",
         });
         while (hasMorePages) {
             pageCount++;
@@ -6498,9 +6813,11 @@ class AlpacaMarketDataAPI extends EventEmitter {
                 feed: DEFAULT_FEED,
                 ...(pageToken && { page_token: pageToken }),
             };
-            const response = await this.makeRequest('/stocks/bars', 'GET', requestParams);
+            const response = await this.makeRequest("/stocks/bars", "GET", requestParams);
             if (!response.bars) {
-                log$1(`No bars data found in response for ${symbolsStr}`, { type: 'warn' });
+                log$1(`No bars data found in response for ${symbolsStr}`, {
+                    type: "warn",
+                });
                 break;
             }
             // Track currency from first response
@@ -6516,7 +6833,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
                     allBars[symbol] = [...allBars[symbol], ...bars];
                     pageBarsCount += bars.length;
                     // Track date range for this page
-                    bars.forEach(bar => {
+                    bars.forEach((bar) => {
                         const barDate = new Date(bar.t);
                         if (!earliestTimestamp || barDate < earliestTimestamp) {
                             earliestTimestamp = barDate;
@@ -6532,21 +6849,23 @@ class AlpacaMarketDataAPI extends EventEmitter {
             hasMorePages = !!pageToken;
             // Enhanced logging with date range and progress info
             const dateRangeStr = earliestTimestamp && latestTimestamp
-                ? `${earliestTimestamp.toLocaleDateString('en-US', { timeZone: 'America/New_York' })} to ${latestTimestamp.toLocaleDateString('en-US', { timeZone: 'America/New_York' })}`
-                : 'unknown range';
-            log$1(`Page ${pageCount}: Fetched ${pageBarsCount.toLocaleString()} bars (total: ${totalBarsCount.toLocaleString()}) for ${symbolsStr}, date range: ${dateRangeStr}${hasMorePages ? ', more pages available' : ', complete'}`, {
-                type: 'info'
+                ? `${earliestTimestamp.toLocaleDateString("en-US", { timeZone: "America/New_York" })} to ${latestTimestamp.toLocaleDateString("en-US", { timeZone: "America/New_York" })}`
+                : "unknown range";
+            log$1(`Page ${pageCount}: Fetched ${pageBarsCount.toLocaleString()} bars (total: ${totalBarsCount.toLocaleString()}) for ${symbolsStr}, date range: ${dateRangeStr}${hasMorePages ? ", more pages available" : ", complete"}`, {
+                type: "info",
             });
             // Prevent infinite loops
             if (pageCount > 1000) {
-                log$1(`Stopping pagination after ${pageCount} pages to prevent infinite loop`, { type: 'warn' });
+                log$1(`Stopping pagination after ${pageCount} pages to prevent infinite loop`, { type: "warn" });
                 break;
             }
         }
         // Final summary
-        const symbolCounts = Object.entries(allBars).map(([symbol, bars]) => `${symbol}: ${bars.length}`).join(', ');
+        const symbolCounts = Object.entries(allBars)
+            .map(([symbol, bars]) => `${symbol}: ${bars.length}`)
+            .join(", ");
         log$1(`Historical bars fetch complete: ${totalBarsCount.toLocaleString()} total bars across ${pageCount} pages (${symbolCounts})`, {
-            type: 'info'
+            type: "info",
         });
         return {
             bars: allBars,
@@ -6562,7 +6881,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
      
      */
     async getLatestBars(symbols, currency) {
-        return this.makeRequest('/stocks/bars/latest', 'GET', {
+        return this.makeRequest("/stocks/bars/latest", "GET", {
             symbols,
             feed: DEFAULT_FEED,
             currency: currency || DEFAULT_CURRENCY,
@@ -6574,7 +6893,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
      * @returns Last trade details including price, size, exchange, and conditions
      */
     async getLastTrade(symbol) {
-        return this.makeRequest(`/v1/last/stocks/${symbol}`, 'GET');
+        return this.makeRequest(`/v1/last/stocks/${symbol}`, "GET");
     }
     /**
      * Get the most recent trades for requested symbols
@@ -6585,7 +6904,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
      
      */
     async getLatestTrades(symbols, feed, currency) {
-        return this.makeRequest('/stocks/trades/latest', 'GET', {
+        return this.makeRequest("/stocks/trades/latest", "GET", {
             symbols,
             feed: feed || DEFAULT_FEED,
             currency: currency || DEFAULT_CURRENCY,
@@ -6601,13 +6920,15 @@ class AlpacaMarketDataAPI extends EventEmitter {
     async getLatestQuotes(symbols, feed, currency) {
         // Return empty response if symbols array is empty to avoid API error
         if (!symbols || symbols.length === 0) {
-            log$1('No symbols provided to getLatestQuotes, returning empty response', { type: 'warn' });
+            log$1("No symbols provided to getLatestQuotes, returning empty response", {
+                type: "warn",
+            });
             return {
                 quotes: {},
                 currency: currency || DEFAULT_CURRENCY,
             };
         }
-        return this.makeRequest('/stocks/quotes/latest', 'GET', {
+        return this.makeRequest("/stocks/quotes/latest", "GET", {
             symbols,
             feed: feed || DEFAULT_FEED,
             currency: currency || DEFAULT_CURRENCY,
@@ -6621,7 +6942,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
      * @returns Latest quote data with symbol and currency information
      */
     async getLatestQuote(symbol, feed, currency) {
-        return this.makeRequest(`/stocks/${symbol}/quotes/latest`, 'GET', {
+        return this.makeRequest(`/stocks/${symbol}/quotes/latest`, "GET", {
             feed: feed || DEFAULT_FEED,
             currency,
         });
@@ -6637,13 +6958,16 @@ class AlpacaMarketDataAPI extends EventEmitter {
         const prevMarketDate = getLastFullTradingDate(date);
         const response = await this.getHistoricalBars({
             symbols: [symbol],
-            timeframe: '1Day',
+            timeframe: "1Day",
             start: prevMarketDate.date.toISOString(),
             end: prevMarketDate.date.toISOString(),
             limit: 1,
         });
         if (!response.bars[symbol] || response.bars[symbol].length === 0) {
-            log$1(`No previous close data available for ${symbol}`, { type: 'error', symbol });
+            log$1(`No previous close data available for ${symbol}`, {
+                type: "error",
+                symbol,
+            });
             return null;
         }
         return response.bars[symbol][0];
@@ -6658,7 +6982,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
     async getHourlyPrices(symbol, start, end) {
         const response = await this.getHistoricalBars({
             symbols: [symbol],
-            timeframe: '1Hour',
+            timeframe: "1Hour",
             start: new Date(start).toISOString(),
             end: new Date(end).toISOString(),
             limit: 96, // Last 96 hours (4 days)
@@ -6675,7 +6999,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
     async getHalfHourlyPrices(symbol, start, end) {
         const response = await this.getHistoricalBars({
             symbols: [symbol],
-            timeframe: '30Min',
+            timeframe: "30Min",
             start: new Date(start).toISOString(),
             end: new Date(end).toISOString(),
             limit: 16 * 2 * 4, // last 4 days, 16 hours per day, 2 bars per hour
@@ -6692,7 +7016,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
     async getDailyPrices(symbol, start, end) {
         const response = await this.getHistoricalBars({
             symbols: [symbol],
-            timeframe: '1Day',
+            timeframe: "1Day",
             start: new Date(start).toISOString(),
             end: new Date(end).toISOString(),
             limit: 100, // Last 100 days
@@ -6724,7 +7048,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
      */
     static analyzeBars(bars) {
         if (!bars || bars.length === 0) {
-            return 'No price data available';
+            return "No price data available";
         }
         const firstBar = bars[0];
         const lastBar = bars[bars.length - 1];
@@ -6749,7 +7073,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
      */
     async getAssets(params) {
         // Endpoint: GET /v2/assets
-        return this.makeRequest('/assets', 'GET', params, 'api'); // use apiURL
+        return this.makeRequest("/assets", "GET", params, "api"); // use apiURL
     }
     /**
      * Get a single asset by symbol or asset_id
@@ -6759,7 +7083,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
      */
     async getAsset(symbolOrAssetId) {
         // Endpoint: GET /v2/assets/{symbol_or_asset_id}
-        return this.makeRequest(`/assets/${encodeURIComponent(symbolOrAssetId)}`, 'GET', undefined, 'api');
+        return this.makeRequest(`/assets/${encodeURIComponent(symbolOrAssetId)}`, "GET", undefined, "api");
     }
     // ===== OPTIONS MARKET DATA METHODS =====
     /**
@@ -6771,7 +7095,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
      */
     async getOptionsChain(params) {
         const { underlying_symbol, ...queryParams } = params;
-        return this.makeRequest(`/options/snapshots/${encodeURIComponent(underlying_symbol)}`, 'GET', queryParams, 'v1beta1');
+        return this.makeRequest(`/options/snapshots/${encodeURIComponent(underlying_symbol)}`, "GET", queryParams, "v1beta1");
     }
     /**
      * Get the most recent trades for requested option contract symbols
@@ -6783,7 +7107,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
     async getLatestOptionsTrades(params) {
         // Remove limit and page_token as they're not supported by this endpoint
         const { limit, page_token, ...requestParams } = params;
-        return this.makeRequest('/options/trades/latest', 'GET', requestParams, 'v1beta1');
+        return this.makeRequest("/options/trades/latest", "GET", requestParams, "v1beta1");
     }
     /**
      * Get the most recent quotes for requested option contract symbols
@@ -6795,7 +7119,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
     async getLatestOptionsQuotes(params) {
         // Remove limit and page_token as they're not supported by this endpoint
         const { limit, page_token, ...requestParams } = params;
-        return this.makeRequest('/options/quotes/latest', 'GET', requestParams, 'v1beta1');
+        return this.makeRequest("/options/quotes/latest", "GET", requestParams, "v1beta1");
     }
     /**
      * Get historical OHLCV bars for option contract symbols
@@ -6807,18 +7131,18 @@ class AlpacaMarketDataAPI extends EventEmitter {
      */
     async getHistoricalOptionsBars(params) {
         const symbols = params.symbols;
-        const symbolsStr = symbols.join(',');
+        const symbolsStr = symbols.join(",");
         let allBars = {};
         let pageToken = null;
         let hasMorePages = true;
         let totalBarsCount = 0;
         let pageCount = 0;
         // Initialize bar arrays for each symbol
-        symbols.forEach(symbol => {
+        symbols.forEach((symbol) => {
             allBars[symbol] = [];
         });
-        log$1(`Starting historical options bars fetch for ${symbolsStr} (${params.timeframe}, ${params.start || 'no start'} to ${params.end || 'no end'})`, {
-            type: 'info'
+        log$1(`Starting historical options bars fetch for ${symbolsStr} (${params.timeframe}, ${params.start || "no start"} to ${params.end || "no end"})`, {
+            type: "info",
         });
         while (hasMorePages) {
             pageCount++;
@@ -6826,9 +7150,11 @@ class AlpacaMarketDataAPI extends EventEmitter {
                 ...params,
                 ...(pageToken && { page_token: pageToken }),
             };
-            const response = await this.makeRequest('/options/bars', 'GET', requestParams, 'v1beta1');
+            const response = await this.makeRequest("/options/bars", "GET", requestParams, "v1beta1");
             if (!response.bars) {
-                log$1(`No options bars data found in response for ${symbolsStr}`, { type: 'warn' });
+                log$1(`No options bars data found in response for ${symbolsStr}`, {
+                    type: "warn",
+                });
                 break;
             }
             // Combine bars for each symbol
@@ -6840,7 +7166,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
                     allBars[symbol] = [...allBars[symbol], ...bars];
                     pageBarsCount += bars.length;
                     // Track date range for this page
-                    bars.forEach(bar => {
+                    bars.forEach((bar) => {
                         const barDate = new Date(bar.t);
                         if (!earliestTimestamp || barDate < earliestTimestamp) {
                             earliestTimestamp = barDate;
@@ -6856,21 +7182,23 @@ class AlpacaMarketDataAPI extends EventEmitter {
             hasMorePages = !!pageToken;
             // Enhanced logging with date range and progress info
             const dateRangeStr = earliestTimestamp && latestTimestamp
-                ? `${earliestTimestamp.toLocaleDateString('en-US', { timeZone: 'America/New_York' })} to ${latestTimestamp.toLocaleDateString('en-US', { timeZone: 'America/New_York' })}`
-                : 'unknown range';
-            log$1(`Page ${pageCount}: Fetched ${pageBarsCount.toLocaleString()} option bars (total: ${totalBarsCount.toLocaleString()}) for ${symbolsStr}, date range: ${dateRangeStr}${hasMorePages ? ', more pages available' : ', complete'}`, {
-                type: 'info'
+                ? `${earliestTimestamp.toLocaleDateString("en-US", { timeZone: "America/New_York" })} to ${latestTimestamp.toLocaleDateString("en-US", { timeZone: "America/New_York" })}`
+                : "unknown range";
+            log$1(`Page ${pageCount}: Fetched ${pageBarsCount.toLocaleString()} option bars (total: ${totalBarsCount.toLocaleString()}) for ${symbolsStr}, date range: ${dateRangeStr}${hasMorePages ? ", more pages available" : ", complete"}`, {
+                type: "info",
             });
             // Prevent infinite loops
             if (pageCount > 1000) {
-                log$1(`Stopping options bars pagination after ${pageCount} pages to prevent infinite loop`, { type: 'warn' });
+                log$1(`Stopping options bars pagination after ${pageCount} pages to prevent infinite loop`, { type: "warn" });
                 break;
             }
         }
         // Final summary
-        const symbolCounts = Object.entries(allBars).map(([symbol, bars]) => `${symbol}: ${bars.length}`).join(', ');
+        const symbolCounts = Object.entries(allBars)
+            .map(([symbol, bars]) => `${symbol}: ${bars.length}`)
+            .join(", ");
         log$1(`Historical options bars fetch complete: ${totalBarsCount.toLocaleString()} total bars across ${pageCount} pages (${symbolCounts})`, {
-            type: 'info'
+            type: "info",
         });
         return {
             bars: allBars,
@@ -6887,18 +7215,18 @@ class AlpacaMarketDataAPI extends EventEmitter {
      */
     async getHistoricalOptionsTrades(params) {
         const symbols = params.symbols;
-        const symbolsStr = symbols.join(',');
+        const symbolsStr = symbols.join(",");
         let allTrades = {};
         let pageToken = null;
         let hasMorePages = true;
         let totalTradesCount = 0;
         let pageCount = 0;
         // Initialize trades arrays for each symbol
-        symbols.forEach(symbol => {
+        symbols.forEach((symbol) => {
             allTrades[symbol] = [];
         });
-        log$1(`Starting historical options trades fetch for ${symbolsStr} (${params.start || 'no start'} to ${params.end || 'no end'})`, {
-            type: 'info'
+        log$1(`Starting historical options trades fetch for ${symbolsStr} (${params.start || "no start"} to ${params.end || "no end"})`, {
+            type: "info",
         });
         while (hasMorePages) {
             pageCount++;
@@ -6906,9 +7234,11 @@ class AlpacaMarketDataAPI extends EventEmitter {
                 ...params,
                 ...(pageToken && { page_token: pageToken }),
             };
-            const response = await this.makeRequest('/options/trades', 'GET', requestParams, 'v1beta1');
+            const response = await this.makeRequest("/options/trades", "GET", requestParams, "v1beta1");
             if (!response.trades) {
-                log$1(`No options trades data found in response for ${symbolsStr}`, { type: 'warn' });
+                log$1(`No options trades data found in response for ${symbolsStr}`, {
+                    type: "warn",
+                });
                 break;
             }
             // Combine trades for each symbol
@@ -6920,7 +7250,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
                     allTrades[symbol] = [...allTrades[symbol], ...trades];
                     pageTradesCount += trades.length;
                     // Track date range for this page
-                    trades.forEach(trade => {
+                    trades.forEach((trade) => {
                         const tradeDate = new Date(trade.t);
                         if (!earliestTimestamp || tradeDate < earliestTimestamp) {
                             earliestTimestamp = tradeDate;
@@ -6936,21 +7266,23 @@ class AlpacaMarketDataAPI extends EventEmitter {
             hasMorePages = !!pageToken;
             // Enhanced logging with date range and progress info
             const dateRangeStr = earliestTimestamp && latestTimestamp
-                ? `${earliestTimestamp.toLocaleDateString('en-US', { timeZone: 'America/New_York' })} to ${latestTimestamp.toLocaleDateString('en-US', { timeZone: 'America/New_York' })}`
-                : 'unknown range';
-            log$1(`Page ${pageCount}: Fetched ${pageTradesCount.toLocaleString()} option trades (total: ${totalTradesCount.toLocaleString()}) for ${symbolsStr}, date range: ${dateRangeStr}${hasMorePages ? ', more pages available' : ', complete'}`, {
-                type: 'info'
+                ? `${earliestTimestamp.toLocaleDateString("en-US", { timeZone: "America/New_York" })} to ${latestTimestamp.toLocaleDateString("en-US", { timeZone: "America/New_York" })}`
+                : "unknown range";
+            log$1(`Page ${pageCount}: Fetched ${pageTradesCount.toLocaleString()} option trades (total: ${totalTradesCount.toLocaleString()}) for ${symbolsStr}, date range: ${dateRangeStr}${hasMorePages ? ", more pages available" : ", complete"}`, {
+                type: "info",
             });
             // Prevent infinite loops
             if (pageCount > 1000) {
-                log$1(`Stopping options trades pagination after ${pageCount} pages to prevent infinite loop`, { type: 'warn' });
+                log$1(`Stopping options trades pagination after ${pageCount} pages to prevent infinite loop`, { type: "warn" });
                 break;
             }
         }
         // Final summary
-        const symbolCounts = Object.entries(allTrades).map(([symbol, trades]) => `${symbol}: ${trades.length}`).join(', ');
+        const symbolCounts = Object.entries(allTrades)
+            .map(([symbol, trades]) => `${symbol}: ${trades.length}`)
+            .join(", ");
         log$1(`Historical options trades fetch complete: ${totalTradesCount.toLocaleString()} total trades across ${pageCount} pages (${symbolCounts})`, {
-            type: 'info'
+            type: "info",
         });
         return {
             trades: allTrades,
@@ -6968,7 +7300,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
     async getOptionsSnapshot(params) {
         // Remove limit and page_token as they may not be supported by this endpoint
         const { limit, page_token, ...requestParams } = params;
-        return this.makeRequest('/options/snapshots', 'GET', requestParams, 'v1beta1');
+        return this.makeRequest("/options/snapshots", "GET", requestParams, "v1beta1");
     }
     /**
      * Get condition codes for options trades or quotes
@@ -6979,7 +7311,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
      * @see https://docs.alpaca.markets/reference/optionmetaconditions
      */
     async getOptionsConditionCodes(tickType) {
-        return this.makeRequest(`/options/meta/conditions/${tickType}`, 'GET', undefined, 'v1beta1');
+        return this.makeRequest(`/options/meta/conditions/${tickType}`, "GET", undefined, "v1beta1");
     }
     /**
      * Get exchange codes for options
@@ -6989,7 +7321,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
      * @see https://docs.alpaca.markets/reference/optionmetaexchanges
      */
     async getOptionsExchangeCodes() {
-        return this.makeRequest('/options/meta/exchanges', 'GET', undefined, 'v1beta1');
+        return this.makeRequest("/options/meta/exchanges", "GET", undefined, "v1beta1");
     }
     /**
      * Analyzes an array of option bars and returns a summary string
@@ -6998,7 +7330,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
      */
     static analyzeOptionBars(bars) {
         if (!bars || bars.length === 0) {
-            return 'No option price data available';
+            return "No option price data available";
         }
         const firstBar = bars[0];
         const lastBar = bars[bars.length - 1];
@@ -7022,7 +7354,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
      */
     static formatOptionGreeks(greeks) {
         if (!greeks) {
-            return 'No greeks data available';
+            return "No greeks data available";
         }
         const parts = [];
         if (greeks.delta !== undefined)
@@ -7035,7 +7367,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
             parts.push(`Vega: ${greeks.vega.toFixed(4)}`);
         if (greeks.rho !== undefined)
             parts.push(`Rho: ${greeks.rho.toFixed(4)}`);
-        return parts.length > 0 ? parts.join(', ') : 'No greeks data available';
+        return parts.length > 0 ? parts.join(", ") : "No greeks data available";
     }
     /**
      * Interprets condition codes using the provided condition codes mapping
@@ -7045,12 +7377,14 @@ class AlpacaMarketDataAPI extends EventEmitter {
      */
     static interpretConditionCodes(conditionCodes, conditionCodesMap) {
         if (!conditionCodes || conditionCodes.length === 0) {
-            return 'No conditions';
+            return "No conditions";
         }
         const descriptions = conditionCodes
             .map((code) => conditionCodesMap[code] || `Unknown (${code})`)
             .filter((desc) => desc !== undefined);
-        return descriptions.length > 0 ? descriptions.join(', ') : 'No condition descriptions available';
+        return descriptions.length > 0
+            ? descriptions.join(", ")
+            : "No condition descriptions available";
     }
     /**
      * Gets the exchange name from exchange code using the provided exchange codes mapping
@@ -7059,7 +7393,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
      * @returns Exchange name or formatted unknown exchange
      */
     static getExchangeName(exchangeCode, exchangeCodesMap) {
-        return exchangeCodesMap[exchangeCode] || `Unknown Exchange (${exchangeCode})`;
+        return (exchangeCodesMap[exchangeCode] || `Unknown Exchange (${exchangeCode})`);
     }
     /**
      * Fetches news articles from Alpaca API for a symbol, paginating through all results.
@@ -7072,7 +7406,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
             start: new Date(Date.now() - 24 * 60 * 60 * 1000),
             end: new Date(),
             limit: 10,
-            sort: 'desc',
+            sort: "desc",
             include_content: true,
         };
         const mergedParams = { ...defaultParams, ...params };
@@ -7086,38 +7420,52 @@ class AlpacaMarketDataAPI extends EventEmitter {
             if (!content)
                 return undefined;
             // Remove excessive whitespace, newlines, and trim
-            return content.replace(/\s+/g, ' ').trim();
+            return content.replace(/\s+/g, " ").trim();
         }
         while (hasMorePages) {
             const queryParams = new URLSearchParams({
-                ...(mergedParams.start && { start: new Date(mergedParams.start).toISOString() }),
-                ...(mergedParams.end && { end: new Date(mergedParams.end).toISOString() }),
+                ...(mergedParams.start && {
+                    start: new Date(mergedParams.start).toISOString(),
+                }),
+                ...(mergedParams.end && {
+                    end: new Date(mergedParams.end).toISOString(),
+                }),
                 ...(symbol && { symbols: symbol }),
-                ...(mergedParams.limit && { limit: Math.min(50, maxLimit - fetchedCount).toString() }),
+                ...(mergedParams.limit && {
+                    limit: Math.min(50, maxLimit - fetchedCount).toString(),
+                }),
                 ...(mergedParams.sort && { sort: mergedParams.sort }),
-                ...(mergedParams.include_content !== undefined ? { include_content: mergedParams.include_content.toString() } : {}),
+                ...(mergedParams.include_content !== undefined
+                    ? { include_content: mergedParams.include_content.toString() }
+                    : {}),
                 ...(pageToken && { page_token: pageToken }),
             });
             const url = `${this.v1beta1url}/news?${queryParams}`;
-            log$1(`Fetching news from: ${url}`, { type: 'debug', symbol });
+            log$1(`Fetching news from: ${url}`, { type: "debug", symbol });
             const response = await fetch(url, {
-                method: 'GET',
+                method: "GET",
                 headers: this.headers,
             });
             if (!response.ok) {
                 const errorText = await response.text();
-                log$1(`Alpaca news API error (${response.status}): ${errorText}`, { type: 'error', symbol });
+                log$1(`Alpaca news API error (${response.status}): ${errorText}`, {
+                    type: "error",
+                    symbol,
+                });
                 throw new Error(`Alpaca news API error (${response.status}): ${errorText}`);
             }
             const data = await response.json();
             if (!data.news || !Array.isArray(data.news)) {
-                log$1(`No news data found in Alpaca response for ${symbol}`, { type: 'warn', symbol });
+                log$1(`No news data found in Alpaca response for ${symbol}`, {
+                    type: "warn",
+                    symbol,
+                });
                 break;
             }
             const transformedNews = data.news.map((article) => ({
                 symbols: article.symbols,
                 title: article.headline,
-                summary: cleanContent(article.summary) ?? '',
+                summary: cleanContent(article.summary) ?? "",
                 content: article.content ? cleanContent(article.content) : undefined,
                 url: article.url,
                 source: article.source,
@@ -7130,7 +7478,7 @@ class AlpacaMarketDataAPI extends EventEmitter {
             fetchedCount = newsArticles.length;
             pageToken = data.next_page_token || null;
             hasMorePages = !!pageToken && (!maxLimit || fetchedCount < maxLimit);
-            log$1(`Fetched ${transformedNews.length} news articles (total: ${fetchedCount}) for ${symbol}. More pages: ${hasMorePages}`, { type: 'debug', symbol });
+            log$1(`Fetched ${transformedNews.length} news articles (total: ${fetchedCount}) for ${symbol}. More pages: ${hasMorePages}`, { type: "debug", symbol });
             if (maxLimit && fetchedCount >= maxLimit) {
                 newsArticles = newsArticles.slice(0, maxLimit);
                 break;
@@ -7161,11 +7509,11 @@ const marketDataAPI = AlpacaMarketDataAPI.getInstance();
  */
 function formatCurrency(value) {
     if (isNaN(value)) {
-        return '$0.00';
+        return "$0.00";
     }
-    return new Intl.NumberFormat('en-US', {
-        style: 'currency',
-        currency: 'USD',
+    return new Intl.NumberFormat("en-US", {
+        style: "currency",
+        currency: "USD",
     }).format(value);
 }
 /**
@@ -7178,13 +7526,13 @@ function formatCurrency(value) {
  */
 function formatNumber(value) {
     if (isNaN(value)) {
-        return '0';
+        return "0";
     }
-    return new Intl.NumberFormat('en-US').format(value);
+    return new Intl.NumberFormat("en-US").format(value);
 }
 
 const log = (message) => {
-    console.log(`[${new Date().toLocaleString('en-US', { timeZone: 'America/New_York' })}] ${message}`);
+    console.log(`[${new Date().toLocaleString("en-US", { timeZone: "America/New_York" })}] ${message}`);
 };
 // async function testCreateEquitiesTrade() {
 //   try {
@@ -7408,18 +7756,18 @@ const log = (message) => {
 // testing retrieving pre-market data (just 9:00am to 9:30am on 1 july 2025 for SPY) using the market data api
 async function testPreMarketData() {
     try {
-        log('Starting pre-market data test for SPY (9:00am-9:30am, July 1, 2025)...');
+        log("Starting pre-market data test for SPY (9:00am-9:30am, July 1, 2025)...");
         // Set up the time range in America/New_York, convert to UTC ISO strings
-        const symbol = 'SPY';
-        const nyTimeZone = 'America/New_York';
+        const symbol = "SPY";
+        const nyTimeZone = "America/New_York";
         // 9:00am and 9:30am in NY time
-        const startNY = new Date('2025-07-01T09:00:00-04:00');
-        const endNY = new Date('2025-07-01T09:30:00-04:00');
+        const startNY = new Date("2025-07-01T09:00:00-04:00");
+        const endNY = new Date("2025-07-01T09:30:00-04:00");
         const startUTC = startNY.toISOString();
         const endUTC = endNY.toISOString();
         const barsResponse = await marketDataAPI.getHistoricalBars({
             symbols: [symbol],
-            timeframe: '1Min',
+            timeframe: "1Min",
             start: startUTC,
             end: endUTC,
             limit: 1000,
@@ -7427,19 +7775,21 @@ async function testPreMarketData() {
         const bars = barsResponse.bars[symbol] || [];
         log(`Fetched ${bars.length} 1-min bars for SPY from 9:00am to 9:30am (NY) on 2025-07-01.`);
         if (bars.length === 0) {
-            log('No pre-market bars returned.');
+            log("No pre-market bars returned.");
             return;
         }
         // Print each bar
         bars.forEach((bar, i) => {
-            const barTime = new Date(bar.t).toLocaleString('en-US', { timeZone: nyTimeZone });
+            const barTime = new Date(bar.t).toLocaleString("en-US", {
+                timeZone: nyTimeZone,
+            });
             log(`Bar ${i + 1}: ${barTime} | O: ${formatCurrency(bar.o)} H: ${formatCurrency(bar.h)} L: ${formatCurrency(bar.l)} C: ${formatCurrency(bar.c)} V: ${formatNumber(bar.v)} VWAP: ${formatCurrency(bar.vw)} N: ${bar.n}`);
         });
         // Print summary
         const summary = AlpacaMarketDataAPI.analyzeBars(bars);
         if (summary)
             log(`Summary: ${summary}`);
-        log('Pre-market data test complete.');
+        log("Pre-market data test complete.");
     }
     catch (error) {
         log(`❌ Error in testPreMarketData: ${error instanceof Error ? error.message : error}`);