cynx-lib 1.3.83 → 1.3.85

package/utils/utils/duration.js

@@ -1,139 +1,139 @@
-/**
- * cynx/utils — Duration Parser and Formatter (duration.js)
- *
- * Universal utility for parsing human-readable duration strings (e.g. '15m', '2h', '3d', '1w', '1mo')
- * into seconds or milliseconds, and formatting durations into short tags or localized labels.
- *
- * Works across Browser and Node.js environments.
- */
-
-/**
- * Parse a human-readable duration string or number into seconds.
- * Supported units:
- *   - s  : seconds (e.g. '30s', '45s')
- *   - m  : minutes (e.g. '1m', '5m', '15m', '30m')
- *   - h  : hours   (e.g. '1h', '5h', '12h', '24h')
- *   - d  : days    (e.g. '1d', '3d', '7d')
- *   - w  : weeks   (e.g. '1w', '2w')
- *   - mo : months  (e.g. '1mo', '3mo', treated as 30 days)
- *
- * @param {string|number} input
- * @param {number} [minSeconds=60] Minimum allowed seconds
- * @returns {number} Seconds
- */
-export function parseDurationToSeconds(input, minSeconds = 60) {
-  if (input === null || input === undefined || input === '') {
-    return minSeconds;
-  }
-
-  if (typeof input === 'number') {
-    if (isNaN(input) || input <= 0) return minSeconds;
-    return Math.max(minSeconds, Math.round(input));
-  }
-
-  const str = String(input).trim().toLowerCase();
-
-  // If plain digits string: '300'
-  if (/^\d+$/.test(str)) {
-    const num = parseInt(str, 10);
-    return Math.max(minSeconds, num);
-  }
-
-  // Match number + unit: '15m', '2h', '1mo', '3d', '1w', '45s'
-  const match = str.match(/^(\d+(?:\.\d+)?)\s*(mo|w|d|h|m|s)?$/);
-  if (!match) {
-    return minSeconds;
-  }
-
-  const val = parseFloat(match[1]);
-  const unit = match[2] || 's';
-
-  let totalSec = 0;
-  switch (unit) {
-    case 'mo':
-      totalSec = val * 30 * 86400; // 30 days
-      break;
-    case 'w':
-      totalSec = val * 7 * 86400;  // 7 days
-      break;
-    case 'd':
-      totalSec = val * 86400;
-      break;
-    case 'h':
-      totalSec = val * 3600;
-      break;
-    case 'm':
-      totalSec = val * 60;
-      break;
-    case 's':
-    default:
-      totalSec = val;
-      break;
-  }
-
-  const rounded = Math.round(totalSec);
-  return Math.max(minSeconds, rounded);
-}
-
-/**
- * Parse a human-readable duration string into milliseconds.
- *
- * @param {string|number} val
- * @param {number} [defaultMs=2592000000] Default ms (30 days)
- * @returns {number} Milliseconds
- */
-export function parseDurationMs(val, defaultMs = 30 * 24 * 60 * 60 * 1000) {
-  if (!val || val === 'off' || val === '0' || val === 0) return 0;
-  if (typeof val === 'number') return val > 0 ? val : defaultMs;
-  const str = String(val).trim().toLowerCase();
-  const match = str.match(/^(\d+(?:\.\d+)?)\s*([a-z]+)?$/);
-  if (!match) return defaultMs;
-  const num = parseFloat(match[1]);
-  const unit = match[2] || 'd';
-  if (unit.startsWith('s')) return Math.round(num * 1000);
-  if (unit.startsWith('m')) return Math.round(num * 60 * 1000);
-  if (unit.startsWith('h')) return Math.round(num * 60 * 60 * 1000);
-  if (unit.startsWith('d')) return Math.round(num * 24 * 60 * 60 * 1000);
-  if (unit.startsWith('w')) return Math.round(num * 7 * 24 * 60 * 60 * 1000);
-  return defaultMs;
-}
-
-/**
- * Format seconds into a short clean tag (e.g. '1m', '5m', '1h', '24h', '1w', '1mo').
- * @param {number} seconds
- * @returns {string} Short duration string
- */
-export function formatDurationTag(seconds) {
-  const s = Number(seconds) || 60;
-  if (s >= 2592000 && s % 2592000 === 0) return `${s / 2592000}mo`;
-  if (s >= 604800 && s % 604800 === 0) return `${s / 604800}w`;
-  if (s >= 86400 && s % 86400 === 0) return `${s / 86400}d`;
-  if (s >= 3600 && s % 3600 === 0) return `${s / 3600}h`;
-  if (s >= 60 && s % 60 === 0) return `${s / 60}m`;
-  return `${s}s`;
-}
-
-/**
- * Format seconds into human readable label.
- * @param {number} seconds
- * @returns {string} Human readable label
- */
-export function formatDurationLabel(seconds) {
-  const s = Number(seconds) || 60;
-  if (s === 60) return '1 мин';
-  if (s === 300) return '5 мин';
-  if (s === 600) return '10 мин';
-  if (s === 1800) return '30 мин';
-  if (s === 3600) return '1 час';
-  if (s === 18000) return '5 часов';
-  if (s === 43200) return '12 часов';
-  if (s === 86400) return '24 часа';
-  return formatDurationTag(s);
-}
-
-export default {
-  parseDurationToSeconds,
-  parseDurationMs,
-  formatDurationTag,
-  formatDurationLabel,
-};
+/**
+ * cynx/utils — Duration Parser and Formatter (duration.js)
+ *
+ * Universal utility for parsing human-readable duration strings (e.g. '15m', '2h', '3d', '1w', '1mo')
+ * into seconds or milliseconds, and formatting durations into short tags or localized labels.
+ *
+ * Works across Browser and Node.js environments.
+ */
+
+/**
+ * Parse a human-readable duration string or number into seconds.
+ * Supported units:
+ *   - s  : seconds (e.g. '30s', '45s')
+ *   - m  : minutes (e.g. '1m', '5m', '15m', '30m')
+ *   - h  : hours   (e.g. '1h', '5h', '12h', '24h')
+ *   - d  : days    (e.g. '1d', '3d', '7d')
+ *   - w  : weeks   (e.g. '1w', '2w')
+ *   - mo : months  (e.g. '1mo', '3mo', treated as 30 days)
+ *
+ * @param {string|number} input
+ * @param {number} [minSeconds=60] Minimum allowed seconds
+ * @returns {number} Seconds
+ */
+export function parseDurationToSeconds(input, minSeconds = 60) {
+  if (input === null || input === undefined || input === '') {
+    return minSeconds;
+  }
+
+  if (typeof input === 'number') {
+    if (isNaN(input) || input <= 0) return minSeconds;
+    return Math.max(minSeconds, Math.round(input));
+  }
+
+  const str = String(input).trim().toLowerCase();
+
+  // If plain digits string: '300'
+  if (/^\d+$/.test(str)) {
+    const num = parseInt(str, 10);
+    return Math.max(minSeconds, num);
+  }
+
+  // Match number + unit: '15m', '2h', '1mo', '3d', '1w', '45s'
+  const match = str.match(/^(\d+(?:\.\d+)?)\s*(mo|w|d|h|m|s)?$/);
+  if (!match) {
+    return minSeconds;
+  }
+
+  const val = parseFloat(match[1]);
+  const unit = match[2] || 's';
+
+  let totalSec = 0;
+  switch (unit) {
+    case 'mo':
+      totalSec = val * 30 * 86400; // 30 days
+      break;
+    case 'w':
+      totalSec = val * 7 * 86400;  // 7 days
+      break;
+    case 'd':
+      totalSec = val * 86400;
+      break;
+    case 'h':
+      totalSec = val * 3600;
+      break;
+    case 'm':
+      totalSec = val * 60;
+      break;
+    case 's':
+    default:
+      totalSec = val;
+      break;
+  }
+
+  const rounded = Math.round(totalSec);
+  return Math.max(minSeconds, rounded);
+}
+
+/**
+ * Parse a human-readable duration string into milliseconds.
+ *
+ * @param {string|number} val
+ * @param {number} [defaultMs=2592000000] Default ms (30 days)
+ * @returns {number} Milliseconds
+ */
+export function parseDurationMs(val, defaultMs = 30 * 24 * 60 * 60 * 1000) {
+  if (!val || val === 'off' || val === '0' || val === 0) return 0;
+  if (typeof val === 'number') return val > 0 ? val : defaultMs;
+  const str = String(val).trim().toLowerCase();
+  const match = str.match(/^(\d+(?:\.\d+)?)\s*([a-z]+)?$/);
+  if (!match) return defaultMs;
+  const num = parseFloat(match[1]);
+  const unit = match[2] || 'd';
+  if (unit.startsWith('s')) return Math.round(num * 1000);
+  if (unit.startsWith('m')) return Math.round(num * 60 * 1000);
+  if (unit.startsWith('h')) return Math.round(num * 60 * 60 * 1000);
+  if (unit.startsWith('d')) return Math.round(num * 24 * 60 * 60 * 1000);
+  if (unit.startsWith('w')) return Math.round(num * 7 * 24 * 60 * 60 * 1000);
+  return defaultMs;
+}
+
+/**
+ * Format seconds into a short clean tag (e.g. '1m', '5m', '1h', '24h', '1w', '1mo').
+ * @param {number} seconds
+ * @returns {string} Short duration string
+ */
+export function formatDurationTag(seconds) {
+  const s = Number(seconds) || 60;
+  if (s >= 2592000 && s % 2592000 === 0) return `${s / 2592000}mo`;
+  if (s >= 604800 && s % 604800 === 0) return `${s / 604800}w`;
+  if (s >= 86400 && s % 86400 === 0) return `${s / 86400}d`;
+  if (s >= 3600 && s % 3600 === 0) return `${s / 3600}h`;
+  if (s >= 60 && s % 60 === 0) return `${s / 60}m`;
+  return `${s}s`;
+}
+
+/**
+ * Format seconds into human readable label.
+ * @param {number} seconds
+ * @returns {string} Human readable label
+ */
+export function formatDurationLabel(seconds) {
+  const s = Number(seconds) || 60;
+  if (s === 60) return '1 мин';
+  if (s === 300) return '5 мин';
+  if (s === 600) return '10 мин';
+  if (s === 1800) return '30 мин';
+  if (s === 3600) return '1 час';
+  if (s === 18000) return '5 часов';
+  if (s === 43200) return '12 часов';
+  if (s === 86400) return '24 часа';
+  return formatDurationTag(s);
+}
+
+export default {
+  parseDurationToSeconds,
+  parseDurationMs,
+  formatDurationTag,
+  formatDurationLabel,
+};