@adaptic/utils 0.1.2 → 0.1.3

package/dist/index.mjs

@@ -300,23 +300,42 @@ const fetchAssetOverview = async (symbol) => {
 /**
  * Validates Alpaca API credentials
  * @param auth - Authentication object containing API key and secret
- * @throws {Error} If credentials are invalid or missing
+ * @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) {
+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) {
-        throw new Error("Invalid Alpaca API key: must be a non-empty string");
+        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) {
-        throw new Error("Invalid Alpaca API secret: must be a non-empty string");
+        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) {
-        throw new Error("Alpaca API key appears to be too short");
+        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;
 }
 /**
  * Validates Polygon API key
@@ -12263,6 +12282,8 @@ class AlpacaMarketDataAPI extends EventEmitter {
     dataURL;
     apiURL;
     v1beta1url;
+    /** 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
@@ -12318,13 +12339,16 @@ class AlpacaMarketDataAPI extends EventEmitter {
     constructor() {
         super();
         // Validate credentials from environment variables before initializing
-        const apiKey = process.env.ALPACA_API_KEY;
-        const apiSecret = process.env.ALPACA_SECRET_KEY;
-        validateAlpacaCredentials({
+        // 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"