cynx-lib 1.3.35 → 1.3.37

package/gen.js

@@ -1,77 +1,77 @@
-#!/usr/bin/env node
-'use strict';
-
-import { uid, prefixedId, uuid, ALPHABETS } from './utils/index.js';
-
-const ALPHABET_MAP = {
-  hex: ALPHABETS.hex,
-  num: ALPHABETS.numeric,
-  numeric: ALPHABETS.numeric,
-  numbers: ALPHABETS.numeric,
-  digits: ALPHABETS.numeric,
-  lc: ALPHABETS.lowercase,
-  lower: ALPHABETS.lowercase,
-  lowercase: ALPHABETS.lowercase,
-  uc: ALPHABETS.uppercase,
-  upper: ALPHABETS.uppercase,
-  uppercase: ALPHABETS.uppercase,
-  mixed: ALPHABETS.alphanumeric,
-  alpha: ALPHABETS.alphanumeric,
-  alphanumeric: ALPHABETS.alphanumeric,
-  url: ALPHABETS.urlSafe,
-  urlsafe: ALPHABETS.urlSafe,
-  'url-safe': ALPHABETS.urlSafe,
-  clean: ALPHABETS.noLookalikes,
-  nolookalikes: ALPHABETS.noLookalikes,
-  'no-lookalikes': ALPHABETS.noLookalikes,
-};
-
-async function main() {
-  const rawArgs = process.argv.slice(2);
-  let prefix = '';
-  let size = 24;
-  let count = 1;
-  let isUuid = false;
-  let alphabet = ALPHABETS.lowercase;
-
-  for (let i = 0; i < rawArgs.length; i++) {
-    const raw = rawArgs[i].trim();
-    const clean = raw.toLowerCase().replace(/^--?/, '');
-
-    if (clean === 'uuid') {
-      isUuid = true;
-    } else if (clean === 'n' || clean === 'count') {
-      count = parseInt(rawArgs[++i], 10) || 1;
-    } else if (clean === 's' || clean === 'size' || clean === 'l' || clean === 'length') {
-      size = parseInt(rawArgs[++i], 10) || 24;
-    } else if (clean === 'p' || clean === 'prefix') {
-      prefix = rawArgs[++i] || '';
-    } else if (clean === 'a' || clean === 'alphabet') {
-      const val = (rawArgs[++i] || '').toLowerCase();
-      alphabet = ALPHABET_MAP[val] || ALPHABETS[val] || val || ALPHABETS.lowercase;
-    } else if (ALPHABET_MAP[clean]) {
-      alphabet = ALPHABET_MAP[clean];
-    } else if (!isNaN(Number(raw)) && /^\d+$/.test(raw)) {
-      size = parseInt(raw, 10);
-    } else if (!prefix && !raw.startsWith('-')) {
-      prefix = raw;
-    }
-  }
-
-  for (let i = 0; i < count; i++) {
-    let result;
-    if (isUuid) {
-      result = uuid();
-    } else if (prefix) {
-      result = prefixedId(prefix, size, alphabet);
-    } else {
-      result = uid(size, alphabet);
-    }
-    console.log(result);
-  }
-}
-
-main().catch((err) => {
-  console.error('[Error]:', err.message);
-  process.exit(1);
-});
+#!/usr/bin/env node
+'use strict';
+
+import { uid, prefixedId, uuid, ALPHABETS } from './utils/index.js';
+
+const ALPHABET_MAP = {
+  hex: ALPHABETS.hex,
+  num: ALPHABETS.numeric,
+  numeric: ALPHABETS.numeric,
+  numbers: ALPHABETS.numeric,
+  digits: ALPHABETS.numeric,
+  lc: ALPHABETS.lowercase,
+  lower: ALPHABETS.lowercase,
+  lowercase: ALPHABETS.lowercase,
+  uc: ALPHABETS.uppercase,
+  upper: ALPHABETS.uppercase,
+  uppercase: ALPHABETS.uppercase,
+  mixed: ALPHABETS.alphanumeric,
+  alpha: ALPHABETS.alphanumeric,
+  alphanumeric: ALPHABETS.alphanumeric,
+  url: ALPHABETS.urlSafe,
+  urlsafe: ALPHABETS.urlSafe,
+  'url-safe': ALPHABETS.urlSafe,
+  clean: ALPHABETS.noLookalikes,
+  nolookalikes: ALPHABETS.noLookalikes,
+  'no-lookalikes': ALPHABETS.noLookalikes,
+};
+
+async function main() {
+  const rawArgs = process.argv.slice(2);
+  let prefix = '';
+  let size = 24;
+  let count = 1;
+  let isUuid = false;
+  let alphabet = ALPHABETS.lowercase;
+
+  for (let i = 0; i < rawArgs.length; i++) {
+    const raw = rawArgs[i].trim();
+    const clean = raw.toLowerCase().replace(/^--?/, '');
+
+    if (clean === 'uuid') {
+      isUuid = true;
+    } else if (clean === 'n' || clean === 'count') {
+      count = parseInt(rawArgs[++i], 10) || 1;
+    } else if (clean === 's' || clean === 'size' || clean === 'l' || clean === 'length') {
+      size = parseInt(rawArgs[++i], 10) || 24;
+    } else if (clean === 'p' || clean === 'prefix') {
+      prefix = rawArgs[++i] || '';
+    } else if (clean === 'a' || clean === 'alphabet') {
+      const val = (rawArgs[++i] || '').toLowerCase();
+      alphabet = ALPHABET_MAP[val] || ALPHABETS[val] || val || ALPHABETS.lowercase;
+    } else if (ALPHABET_MAP[clean]) {
+      alphabet = ALPHABET_MAP[clean];
+    } else if (!isNaN(Number(raw)) && /^\d+$/.test(raw)) {
+      size = parseInt(raw, 10);
+    } else if (!prefix && !raw.startsWith('-')) {
+      prefix = raw;
+    }
+  }
+
+  for (let i = 0; i < count; i++) {
+    let result;
+    if (isUuid) {
+      result = uuid();
+    } else if (prefix) {
+      result = prefixedId(prefix, size, alphabet);
+    } else {
+      result = uid(size, alphabet);
+    }
+    console.log(result);
+  }
+}
+
+main().catch((err) => {
+  console.error('[Error]:', err.message);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cynx-lib",
-  "version": "1.3.35",
+  "version": "1.3.37",
   "type": "module",
   "main": "./index.js",
   "bin": {

package/utils/index.js

@@ -1,11 +1,18 @@
-// cynx/utils — shared utility functions
-export * from './utils/uid.js';
-export * from './utils/realtime.js';
-export * from './utils/tz.js';
-export * from './utils/oidc.js';
-
-export { default as uidUtil } from './utils/uid.js';
-export { default as realtimeUtil } from './utils/realtime.js';
-export { default as tzUtil } from './utils/tz.js';
-export { default as oidcUtil } from './utils/oidc.js';
-
+// cynx/utils — shared utility functions
+export * from './utils/uid.js';
+export * from './utils/realtime.js';
+export * from './utils/tz.js';
+export * from './utils/oidc.js';
+export * from './utils/storage.js';
+export * from './utils/duration.js';
+export * from './utils/session.js';
+export * from './utils/ui.js';
+
+export { default as uidUtil } from './utils/uid.js';
+export { default as realtimeUtil } from './utils/realtime.js';
+export { default as tzUtil } from './utils/tz.js';
+export { default as oidcUtil } from './utils/oidc.js';
+export { default as storageUtil } from './utils/storage.js';
+export { default as durationUtil } from './utils/duration.js';
+export { default as sessionUtil } from './utils/session.js';
+export { default as uiUtil } from './utils/ui.js';

package/utils/utils/duration.js

@@ -0,0 +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,
+};