@discomedia/utils 1.0.19 → 1.0.21

package/README.md

@@ -12,6 +12,11 @@ NPM repo: https://www.npmjs.com/package/@discomedia/utils
 npm install @discomedia/utils
 ```
 
+> **Note:**
+> The [`tslib`](https://www.npmjs.com/package/tslib) package is required for building this library on GitHub Actions and other CI environments.
+> It is included as a dependency because Rollup and TypeScript emit helpers that require `tslib` at build time.
+> Do not remove `tslib` from dependencies, or CI builds will fail.
+
 ## Usage
 
 This package provides two different entry points depending on your environment:

package/dist/index-frontend.cjs

@@ -249,7 +249,7 @@ const safeJSON = (text) => {
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
-const VERSION = '5.10.1'; // x-release-please-version
+const VERSION = '5.10.2'; // x-release-please-version
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 const isRunningInBrowser = () => {
@@ -12854,7 +12854,7 @@ var config = {};
 
 var main = {exports: {}};
 
-var version = "17.2.0";
+var version = "17.2.1";
 var require$$4 = {
 	version: version};
 
@@ -12873,9 +12873,12 @@ function requireMain () {
 
 	// Array of tips to display randomly
 	const TIPS = [
-	  '🔐 encrypt with dotenvx: https://dotenvx.com',
+	  '🔐 encrypt with Dotenvx: https://dotenvx.com',
 	  '🔐 prevent committing .env to code: https://dotenvx.com/precommit',
 	  '🔐 prevent building .env in docker: https://dotenvx.com/prebuild',
+	  '📡 observe env with Radar: https://dotenvx.com/radar',
+	  '📡 auto-backup env with Radar: https://dotenvx.com/radar',
+	  '📡 version env with Radar: https://dotenvx.com/radar',
 	  '🛠️  run anywhere with `dotenvx run -- yourcommand`',
 	  '⚙️  specify custom .env file path with { path: \'/custom/path/.env\' }',
 	  '⚙️  enable debug logging with { debug: true }',
@@ -13176,7 +13179,7 @@ function requireMain () {
 	      }
 	    }
 
-	    _log(`injecting env (${keysCount}) from ${shortPaths.join(',')} ${dim(`(tip: ${_getRandomTip()})`)}`);
+	    _log(`injecting env (${keysCount}) from ${shortPaths.join(',')} ${dim(`-- tip: ${_getRandomTip()}`)}`);
 	  }
 
 	  if (lastError) {
@@ -13489,6 +13492,11 @@ const MARKET_CONFIG = {
         EARLY_CLOSE: { hour: 13, minute: 0 }},
 };
 // Helper: Get NY offset for a given UTC date (DST rules for US)
+/**
+ * Returns the NY timezone offset (in hours) for a given UTC date, accounting for US DST rules.
+ * @param date - UTC date
+ * @returns offset in hours (-5 for EST, -4 for EDT)
+ */
 function getNYOffset(date) {
     // US DST starts 2nd Sunday in March, ends 1st Sunday in November
     const year = date.getUTCFullYear();
@@ -13501,6 +13509,14 @@ function getNYOffset(date) {
     return MARKET_CONFIG.UTC_OFFSET_STANDARD;
 }
 // Helper: Get nth weekday of month in UTC
+/**
+ * Returns the nth weekday of a given month in UTC.
+ * @param year - Year
+ * @param month - 1-based month (e.g. March = 3)
+ * @param weekday - 0=Sunday, 1=Monday, ...
+ * @param n - nth occurrence
+ * @returns Date object for the nth weekday
+ */
 function getNthWeekdayOfMonth(year, month, weekday, n) {
     let count = 0;
     for (let d = 1; d <= 31; d++) {
@@ -13517,6 +13533,11 @@ function getNthWeekdayOfMonth(year, month, weekday, n) {
     return new Date(Date.UTC(year, month - 1, 28));
 }
 // Helper: Convert UTC date to NY time (returns new Date object)
+/**
+ * Converts a UTC date to NY time (returns a new Date object).
+ * @param date - UTC date
+ * @returns Date object in NY time
+ */
 function toNYTime(date) {
     const offset = getNYOffset(date);
     // NY offset in hours
@@ -13525,6 +13546,11 @@ function toNYTime(date) {
     return new Date(nyMillis);
 }
 // Helper: Convert NY time to UTC (returns new Date object)
+/**
+ * Converts a NY time date to UTC (returns a new Date object).
+ * @param date - NY time date
+ * @returns Date object in UTC
+ */
 function fromNYTime(date) {
     const offset = getNYOffset(date);
     const nyMillis = date.getTime();
@@ -13532,11 +13558,24 @@ function fromNYTime(date) {
     return new Date(utcMillis);
 }
 // Market calendar logic
+/**
+ * Market calendar logic for holidays, weekends, and market days.
+ */
 class MarketCalendar {
+    /**
+     * Checks if a date is a weekend in NY time.
+     * @param date - Date object
+     * @returns true if weekend, false otherwise
+     */
     isWeekend(date) {
         const day = toNYTime(date).getUTCDay();
         return day === 0 || day === 6;
     }
+    /**
+     * Checks if a date is a market holiday in NY time.
+     * @param date - Date object
+     * @returns true if holiday, false otherwise
+     */
     isHoliday(date) {
         const nyDate = toNYTime(date);
         const year = nyDate.getUTCFullYear();
@@ -13546,8 +13585,13 @@ class MarketCalendar {
         const yearHolidays = marketHolidays[year];
         if (!yearHolidays)
             return false;
-        return Object.values(yearHolidays).some(holiday => holiday.date === formattedDate);
+        return Object.values(yearHolidays).some((holiday) => holiday.date === formattedDate);
     }
+    /**
+     * Checks if a date is an early close day in NY time.
+     * @param date - Date object
+     * @returns true if early close, false otherwise
+     */
     isEarlyCloseDay(date) {
         const nyDate = toNYTime(date);
         const year = nyDate.getUTCFullYear();
@@ -13557,6 +13601,11 @@ class MarketCalendar {
         const yearEarlyCloses = marketEarlyCloses[year];
         return yearEarlyCloses && yearEarlyCloses[formattedDate] !== undefined;
     }
+    /**
+     * Gets the early close time (in minutes from midnight) for a given date.
+     * @param date - Date object
+     * @returns minutes from midnight or null
+     */
     getEarlyCloseTime(date) {
         const nyDate = toNYTime(date);
         const year = nyDate.getUTCFullYear();
@@ -13570,9 +13619,19 @@ class MarketCalendar {
         }
         return null;
     }
+    /**
+     * Checks if a date is a market day (not weekend or holiday).
+     * @param date - Date object
+     * @returns true if market day, false otherwise
+     */
     isMarketDay(date) {
         return !this.isWeekend(date) && !this.isHoliday(date);
     }
+    /**
+     * Gets the next market day after the given date.
+     * @param date - Date object
+     * @returns Date object for next market day
+     */
     getNextMarketDay(date) {
         let nextDay = new Date(date.getTime() + 24 * 60 * 60 * 1000);
         while (!this.isMarketDay(nextDay)) {
@@ -13580,6 +13639,11 @@ class MarketCalendar {
         }
         return nextDay;
     }
+    /**
+     * Gets the previous market day before the given date.
+     * @param date - Date object
+     * @returns Date object for previous market day
+     */
     getPreviousMarketDay(date) {
         let prevDay = new Date(date.getTime() - 24 * 60 * 60 * 1000);
         while (!this.isMarketDay(prevDay)) {
@@ -13589,6 +13653,11 @@ class MarketCalendar {
     }
 }
 // Get last full trading date
+/**
+ * Returns the last full trading date (market close) for a given date.
+ * @param currentDate - Date object (default: now)
+ * @returns Date object for last full trading date
+ */
 function getLastFullTradingDateImpl(currentDate = new Date()) {
     const calendar = new MarketCalendar();
     const nyDate = toNYTime(currentDate);
@@ -13599,7 +13668,9 @@ function getLastFullTradingDateImpl(currentDate = new Date()) {
         marketCloseMinutes = MARKET_CONFIG.TIMES.EARLY_CLOSE.hour * 60 + MARKET_CONFIG.TIMES.EARLY_CLOSE.minute;
     }
     // If not a market day, or before open, or during market hours, return previous market day's close
-    if (!calendar.isMarketDay(currentDate) || minutes < marketOpenMinutes || (minutes >= marketOpenMinutes && minutes < marketCloseMinutes)) {
+    if (!calendar.isMarketDay(currentDate) ||
+        minutes < marketOpenMinutes ||
+        (minutes >= marketOpenMinutes && minutes < marketCloseMinutes)) {
         const prevMarketDay = calendar.getPreviousMarketDay(currentDate);
         let prevCloseMinutes = MARKET_CONFIG.TIMES.MARKET_CLOSE.hour * 60 + MARKET_CONFIG.TIMES.MARKET_CLOSE.minute;
         if (calendar.isEarlyCloseDay(prevMarketDay)) {
@@ -13623,6 +13694,11 @@ function getLastFullTradingDateImpl(currentDate = new Date()) {
 /**
  * Returns the last full trading date as a Date object.
  */
+/**
+ * Returns the last full trading date as a Date object.
+ * @param currentDate - Date object (default: now)
+ * @returns Date object for last full trading date
+ */
 function getLastFullTradingDate(currentDate = new Date()) {
     return getLastFullTradingDateImpl(currentDate);
 }