@adaptic/utils 0.0.1028 → 0.0.1030

package/dist/index.mjs

@@ -817,11 +817,15 @@ let fs;
 let path;
 if (isNode) {
     try {
-        const readline = require("readline");
+        // Referenced inside the guard: in a browser bundle `require` is not defined,
+        // and touching the identifier at module scope would throw before the catch
+        // below could degrade the module to no-ops.
+        const loadNodeBuiltin = require;
+        const readline = loadNodeBuiltin("readline");
         clearLine = readline.clearLine;
         cursorTo = readline.cursorTo;
-        fs = require("fs");
-        path = require("path");
+        fs = loadNodeBuiltin("fs");
+        path = loadNodeBuiltin("path");
     }
     catch {
         // Silently degrade — all operations will be no-ops.
@@ -7006,7 +7010,7 @@ async function makeRequest(auth, params) {
         });
         // Handle 207 Multi-Status responses (used by closeAll positions)
         if (response.status === 207 || response.ok) {
-            return await response.json();
+            return (await response.json());
         }
         const errorText = await response.text();
         getLogger().error(`Alpaca API error (${response.status}): ${errorText}`, {
@@ -8641,8 +8645,7 @@ async function fetchAccountDetails({ accountId, client, alpacaAccount, auth, })
         if (!response.ok) {
             throw new Error(`Failed to fetch account details: ${response.statusText}`);
         }
-        const data = await response.json();
-        return data;
+        return (await response.json());
     }
     catch (error) {
         getLogger().error("Error in fetchAccountDetails:", error);
@@ -8709,8 +8712,7 @@ async function fetchPortfolioHistory({ params, accountId, client, alpacaAccount,
             const errorText = await response.text();
             throw new Error(`Failed to fetch portfolio history: ${response.status} ${response.statusText} ${errorText}`);
         }
-        const data = await response.json();
-        return data;
+        return (await response.json());
     }
     catch (error) {
         getLogger().error("[fetchPortfolioHistory] Error fetching portfolio history call to Alpaca:", error);
@@ -9265,8 +9267,7 @@ const fetchQuote = async (ticker, options) => {
             if (!response.ok) {
                 throw new Error(`Failed to fetch quote for ${ticker}: ${response.status}`);
             }
-            const data = await response.json();
-            return data;
+            return (await response.json());
         }, API_RETRY_CONFIGS.ALPHA_VANTAGE, `AlphaVantage.fetchQuote(${ticker})`);
     });
 };
@@ -9498,7 +9499,7 @@ async function fetchBars(params) {
                     const errorText = await response.text();
                     throw new Error(`Alpaca API error (${response.status}): ${errorText}`);
                 }
-                const data = await response.json();
+                const data = (await response.json());
                 // Convert timestamp strings to Date objects and merge bars
                 Object.entries(data.bars).forEach(([symbol, bars]) => {
                     if (allBars[symbol]) {
@@ -9576,7 +9577,7 @@ async function fetchNews(params, auth) {
                 const errorText = await response.text();
                 throw new Error(`Alpaca API error (${response.status}): ${errorText}`);
             }
-            const data = await response.json();
+            const data = (await response.json());
             const pageArticles = (data.news ?? []).map((article) => ({
                 id: article.id,
                 author: article.author,
@@ -9645,7 +9646,7 @@ async function fetchLatestTrades(params, auth) {
             const errorText = await response.text();
             throw new Error(`Alpaca API error (${response.status}): ${errorText}`);
         }
-        const data = await response.json();
+        const data = (await response.json());
         logIfDebug(`Received latest trades for ${Object.keys(data.trades).length} symbols`);
         return data;
     }, API_RETRY_CONFIGS.CRYPTO, `Crypto.fetchLatestTrades(${symbolsParam})`);
@@ -9688,7 +9689,7 @@ async function fetchLatestQuotes(params, auth) {
             const errorText = await response.text();
             throw new Error(`Alpaca API error (${response.status}): ${errorText}`);
         }
-        const data = await response.json();
+        const data = (await response.json());
         logIfDebug(`Received latest quotes for ${Object.keys(data.quotes).length} symbols`);
         return data;
     }, API_RETRY_CONFIGS.CRYPTO, `Crypto.fetchLatestQuotes(${symbolsParam})`);
@@ -9898,6 +9899,39 @@ function normalizeMassiveSymbol(symbol) {
     }
     return `X:${base.toUpperCase()}-${quote.toUpperCase()}`;
 }
+/**
+ * Fields of {@link MassiveTickerInfo} that carry no sensible default and whose
+ * absence therefore makes a ticker-details response unusable rather than
+ * merely sparse.
+ */
+const REQUIRED_TICKER_FIELDS = [
+    "active",
+    "currency_name",
+    "locale",
+    "market",
+    "name",
+    "primary_exchange",
+    "ticker",
+    "type",
+];
+/**
+ * Rejects a ticker payload that is missing a field {@link MassiveTickerInfo}
+ * declares as required, naming the first field found absent.
+ *
+ * The vendor answers 200 for a partially-populated ticker, so without this
+ * check an absent field would be published to consumers as a value typed
+ * `string` that holds `undefined` — an unknown masquerading as a reading.
+ *
+ * @param results - The ticker payload as received from the vendor.
+ * @throws When any required field is absent.
+ */
+function assertRequiredTickerFields(results) {
+    for (const field of REQUIRED_TICKER_FIELDS) {
+        if (results[field] === undefined) {
+            throw new Error(`Missing required field in Massive API response: ${field}`);
+        }
+    }
+}
 // Use to update general information about stocks
 /**
  * Fetches general information about a stock ticker.
@@ -9920,7 +9954,7 @@ const fetchTickerInfo = async (symbol, options) => {
         await rateLimiters$1.massive.acquire();
         try {
             const response = await fetchWithRetry(`${baseUrl}?${params.toString()}`, { signal: createTimeoutSignal(DEFAULT_TIMEOUTS.MASSIVE_API) }, 3, 1000);
-            const data = await response.json();
+            const data = (await response.json());
             // Check for "NOT_FOUND" status and return null
             if (data.status === "NOT_FOUND") {
                 getLogger().warn(`Ticker not found: ${symbol}`);
@@ -9932,21 +9966,7 @@ const fetchTickerInfo = async (symbol, options) => {
                 throw new Error("No results in Massive API response");
             }
             // Validate required fields
-            const requiredFields = [
-                "active",
-                "currency_name",
-                "locale",
-                "market",
-                "name",
-                "primary_exchange",
-                "ticker",
-                "type",
-            ];
-            for (const field of requiredFields) {
-                if (results[field] === undefined) {
-                    throw new Error(`Missing required field in Massive API response: ${field}`);
-                }
-            }
+            assertRequiredTickerFields(results);
             // Handle optional share_class_shares_outstanding field
             if (results.share_class_shares_outstanding === undefined) {
                 results.share_class_shares_outstanding = null;
@@ -10192,7 +10212,7 @@ const fetchPrices = async (params, options) => {
                 //getLogger().info(`Debug: Fetching ${nextUrl}`);
                 await rateLimiters$1.massive.acquire();
                 const response = await fetchWithRetry(nextUrl, { signal: createTimeoutSignal(DEFAULT_TIMEOUTS.MASSIVE_API) }, 3, 1000);
-                const data = await response.json();
+                const data = (await response.json());
                 if (!MASSIVE_VALID_STATUSES.has(data.status)) {
                     throw new Error(`Massive.com API responded with status: ${data.status}`);
                 }
@@ -10219,7 +10239,7 @@ const fetchPrices = async (params, options) => {
                 receivedAt: new Date(),
                 ...(aggregatedStatus === "DELAYED" ? { delayedSince: null } : {}),
             };
-            return allResults.map((entry) => ({
+            const bars = allResults.map((entry) => ({
                 date: new Date(entry.t).toLocaleString("en-US", {
                     year: "numeric",
                     month: "short",
@@ -10241,6 +10261,12 @@ const fetchPrices = async (params, options) => {
                 trades: entry.n,
                 _freshness: freshness,
             }));
+            // The aggregates endpoint names the ticker once on the envelope rather
+            // than on each bar, and this mapping does not copy it down, so the bars
+            // carry every field of `MassivePriceData` except `symbol`. The assertion
+            // records that divergence at the single point where it arises instead of
+            // leaving it implicit in an untyped payload.
+            return bars;
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
@@ -10380,7 +10406,7 @@ const fetchGroupedDaily = async (date, options) => {
         await rateLimiters$1.massive.acquire();
         try {
             const response = await fetchWithRetry(`${baseUrl}?${params.toString()}`, { signal: createTimeoutSignal(DEFAULT_TIMEOUTS.MASSIVE_API) }, 3, 1000);
-            const data = await response.json();
+            const data = (await response.json());
             if (!MASSIVE_VALID_STATUSES.has(data.status)) {
                 throw new Error(`Massive.com API responded with status: ${data.status}`);
             }
@@ -10402,6 +10428,10 @@ const fetchGroupedDaily = async (date, options) => {
                     trades: result.n,
                 })),
             };
+            // Grouped daily bars are keyed by timestamp only; this mapping does not
+            // derive the human-readable `date` string that `MassivePriceData` also
+            // declares, so the reshaped bars carry every field except that one. The
+            // assertion records that divergence at its single point of origin.
             return groupedDaily;
         }
         catch (error) {
@@ -10474,7 +10504,7 @@ symbol, date = new Date(), options) => {
         await rateLimiters$1.massive.acquire();
         try {
             const response = await fetchWithRetry(`${baseUrl}?${params.toString()}`, { signal: createTimeoutSignal(DEFAULT_TIMEOUTS.MASSIVE_API) }, 3, 1000);
-            const data = await response.json();
+            const data = (await response.json());
             if (!MASSIVE_VALID_STATUSES.has(data.status)) {
                 throw new Error(`Failed to fetch daily open/close data for ${symbol}: ${data.status}`);
             }
@@ -10606,6 +10636,19 @@ const validateApiKey = (apiKey) => {
     }
     return key;
 };
+/**
+ * Narrows a decoded Massive Indices body to its error form.
+ *
+ * The API reports failures in band: the transport answers 200 and the `status`
+ * word carries the outcome, so the body has to be classified before any of its
+ * success fields can be read. Expressing that classification as a type guard is
+ * what lets each fetcher return its payload directly rather than asserting a
+ * success shape over a body that may be an error.
+ *
+ * @param body - A decoded Massive Indices response body.
+ * @returns True when the body reports an error rather than a payload.
+ */
+const isIndicesErrorResponse = (body) => body.status === "ERROR";
 /**
  * Fetches aggregate bars for an index over a given date range in custom time window sizes.
  *
@@ -10631,8 +10674,8 @@ const fetchIndicesAggregates = async (params, options) => {
         await rateLimiters$1.massive.acquire();
         try {
             const response = await fetchWithRetry(url.toString(), { signal: createTimeoutSignal(DEFAULT_TIMEOUTS.MASSIVE_API) }, 3, 300);
-            const data = await response.json();
-            if (data.status === "ERROR") {
+            const data = (await response.json());
+            if (isIndicesErrorResponse(data)) {
                 throw new Error(`Massive API Error: ${data.error}`);
             }
             return data;
@@ -10661,8 +10704,8 @@ const fetchIndicesPreviousClose = async (indicesTicker, options) => {
         await rateLimiters$1.massive.acquire();
         try {
             const response = await fetchWithRetry(url.toString(), { signal: createTimeoutSignal(DEFAULT_TIMEOUTS.MASSIVE_API) }, 3, 300);
-            const data = await response.json();
-            if (data.status === "ERROR") {
+            const data = (await response.json());
+            if (isIndicesErrorResponse(data)) {
                 throw new Error(`Massive API Error: ${data.error}`);
             }
             return data;
@@ -10692,8 +10735,8 @@ const fetchIndicesDailyOpenClose = async (indicesTicker, date, options) => {
         await rateLimiters$1.massive.acquire();
         try {
             const response = await fetchWithRetry(url.toString(), { signal: createTimeoutSignal(DEFAULT_TIMEOUTS.MASSIVE_API) }, 3, 300);
-            const data = await response.json();
-            if (data.status === "ERROR") {
+            const data = (await response.json());
+            if (isIndicesErrorResponse(data)) {
                 throw new Error(`Massive API Error: ${data.error}`);
             }
             return data;
@@ -10734,8 +10777,8 @@ const fetchIndicesSnapshot = async (params, options) => {
         await rateLimiters$1.massive.acquire();
         try {
             const response = await fetchWithRetry(url.toString(), { signal: createTimeoutSignal(DEFAULT_TIMEOUTS.MASSIVE_API) }, 3, 300);
-            const data = await response.json();
-            if (data.status === "ERROR") {
+            const data = (await response.json());
+            if (isIndicesErrorResponse(data)) {
                 throw new Error(`Massive API Error: ${data.error}`);
             }
             return data;
@@ -10783,8 +10826,8 @@ const fetchUniversalSnapshot = async (tickers, options) => {
         await rateLimiters$1.massive.acquire();
         try {
             const response = await fetchWithRetry(url.toString(), { signal: createTimeoutSignal(DEFAULT_TIMEOUTS.MASSIVE_API) }, 3, 300);
-            const data = await response.json();
-            if (data.status === "ERROR") {
+            const data = (await response.json());
+            if (isIndicesErrorResponse(data)) {
                 throw new Error(`Massive API Error: ${data.error}`);
             }
             return data;
@@ -56541,9 +56584,12 @@ function stripHtml(html) {
         .replace(/”/g, '"')
         .replace(/‘/g, "'")
         .replace(/’/g, "'");
-    // Decode numeric HTML entities
-    text = text.replace(/&#(\d+);/g, (_, code) => String.fromCharCode(parseInt(code, 10)));
-    text = text.replace(/&#x([0-9a-fA-F]+);/g, (_, code) => String.fromCharCode(parseInt(code, 16)));
+    // Decode numeric HTML entities. The replacer's capture arguments are declared
+    // by `String.prototype.replace` as `...args: any[]`, since their count depends
+    // on the pattern; each pattern here has exactly one capture group, and a
+    // matched group is always a string, so the parameters are named accordingly.
+    text = text.replace(/&#(\d+);/g, (_match, code) => String.fromCharCode(parseInt(code, 10)));
+    text = text.replace(/&#x([0-9a-fA-F]+);/g, (_match, code) => String.fromCharCode(parseInt(code, 16)));
     // Normalize whitespace
     text = text.replace(/\s+/g, " ").trim();
     return text;