@discomedia/utils 1.0.51 → 1.0.52

package/dist/index.mjs

@@ -967,10 +967,13 @@ function countTradingDays(startDate, endDate = new Date()) {
 /**
  * Returns the trading day N days back from a reference date, along with its market open time.
  * Trading days are counted as full or half trading days (days that end count as 1 full trading day).
+ * By default, the most recent completed trading day counts as day 1.
+ * Set includeMostRecentFullDay to false to count strictly before that day.
  *
  * @param options - Object with:
  *   - referenceDate: Date to count back from (default: now)
- *   - days: Number of trading days to go back (must be >= 1)
+ *   - days: Number of trading days to go back (must be an integer >= 1)
+ *   - includeMostRecentFullDay: Whether to include the most recent completed trading day (default: true)
  * @returns Object containing:
  *   - date: Trading date in YYYY-MM-DD format
  *   - marketOpenISO: Market open time as ISO string (e.g., "2025-11-15T13:30:00.000Z")
@@ -992,13 +995,17 @@ function countTradingDays(startDate, endDate = new Date()) {
  */
 function getTradingDaysBack(options) {
     const calendar = new MarketCalendar();
-    const refDate = options.referenceDate || new Date();
-    const daysBack = options.days;
-    if (daysBack < 1) {
-        throw new Error('days must be at least 1');
+    const { referenceDate, days, includeMostRecentFullDay = true } = options;
+    const refDate = referenceDate || new Date();
+    const daysBack = days;
+    if (!Number.isInteger(daysBack) || daysBack < 1) {
+        throw new Error('days must be an integer >= 1');
     }
     // Start from the last full trading date relative to reference
     let targetDate = getLastFullTradingDateImpl(refDate);
+    if (!includeMostRecentFullDay) {
+        targetDate = calendar.getPreviousMarketDay(targetDate);
+    }
     // Go back the specified number of days (we're already at day 1, so go back days-1 more)
     for (let i = 1; i < daysBack; i++) {
         targetDate = calendar.getPreviousMarketDay(targetDate);