@ls-stack/utils 2.7.0 → 2.8.0

package/dist/cache.d.cts

@@ -12,7 +12,7 @@ type Options = {
      */
     maxItemAge?: number;
     /**
-     * The maximum number of items to check for expiration in a single call.
+     * The throttle for checking expired items in milliseconds.
      * @default 10_000
      */
     expirationThrottle?: number;

package/dist/cache.d.ts

@@ -12,7 +12,7 @@ type Options = {
      */
     maxItemAge?: number;
     /**
-     * The maximum number of items to check for expiration in a single call.
+     * The throttle for checking expired items in milliseconds.
      * @default 10_000
      */
     expirationThrottle?: number;

package/dist/castValues.js

@@ -1,15 +1,7 @@
-// src/castValues.ts
-function castToString(value) {
-  const valueType = typeof value;
-  return valueType === "string" || valueType === "number" || valueType === "boolean" || valueType === "bigint" ? String(value) : null;
-}
-function castToNumber(value) {
-  return isNumeric(value) ? Number(value) : null;
-}
-function isNumeric(num) {
-  const str = String(num);
-  return !isNaN(str) && !isNaN(parseFloat(str));
-}
+import {
+  castToNumber,
+  castToString
+} from "./chunk-GBFS2I67.js";
 export {
   castToNumber,
   castToString

package/dist/chunk-GBFS2I67.js

@@ -0,0 +1,17 @@
+// src/castValues.ts
+function castToString(value) {
+  const valueType = typeof value;
+  return valueType === "string" || valueType === "number" || valueType === "boolean" || valueType === "bigint" ? String(value) : null;
+}
+function castToNumber(value) {
+  return isNumeric(value) ? Number(value) : null;
+}
+function isNumeric(num) {
+  const str = String(num);
+  return !isNaN(str) && !isNaN(parseFloat(str));
+}
+
+export {
+  castToString,
+  castToNumber
+};

package/dist/main.d.ts

@@ -26,6 +26,7 @@
 ///<reference path="sleep.d.ts" />
 ///<reference path="stringUtils.d.ts" />
 ///<reference path="testUtils.d.ts" />
+///<reference path="time.d.ts" />
 ///<reference path="typingFnUtils.d.ts" />
 ///<reference path="typingTestUtils.d.ts" />
 ///<reference path="typingUtils.d.ts" />

package/dist/time.cjs

@@ -0,0 +1,139 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/time.ts
+var time_exports = {};
+__export(time_exports, {
+  DAY_AS_MS: () => DAY_AS_MS,
+  DAY_AS_SECS: () => DAY_AS_SECS,
+  HOUR_AS_MS: () => HOUR_AS_MS,
+  HOUR_AS_SECS: () => HOUR_AS_SECS,
+  MINUTE_AS_MS: () => MINUTE_AS_MS,
+  MONTH_AS_MS: () => MONTH_AS_MS,
+  MONTH_AS_SECS: () => MONTH_AS_SECS,
+  WEEK_AS_MS: () => WEEK_AS_MS,
+  WEEK_AS_SECS: () => WEEK_AS_SECS,
+  YEAR_AS_MS: () => YEAR_AS_MS,
+  YEAR_AS_SECS: () => YEAR_AS_SECS,
+  dateStringOrNullToUnixMs: () => dateStringOrNullToUnixMs,
+  getUnixSeconds: () => getUnixSeconds,
+  msToTimeString: () => msToTimeString,
+  parseTimeStringToMs: () => parseTimeStringToMs
+});
+module.exports = __toCommonJS(time_exports);
+
+// src/castValues.ts
+function castToNumber(value) {
+  return isNumeric(value) ? Number(value) : null;
+}
+function isNumeric(num) {
+  const str = String(num);
+  return !isNaN(str) && !isNaN(parseFloat(str));
+}
+
+// src/mathUtils.ts
+function clampMax(value, max) {
+  return value > max ? max : value;
+}
+
+// src/time.ts
+var MINUTE_AS_MS = 60 * 1e3;
+var HOUR_AS_MS = 60 * MINUTE_AS_MS;
+var DAY_AS_MS = 24 * HOUR_AS_MS;
+var WEEK_AS_MS = 7 * DAY_AS_MS;
+var MONTH_AS_MS = 30 * DAY_AS_MS;
+var YEAR_AS_MS = 365 * DAY_AS_MS;
+var HOUR_AS_SECS = 60 * 60;
+var DAY_AS_SECS = 24 * HOUR_AS_SECS;
+var WEEK_AS_SECS = 7 * DAY_AS_SECS;
+var MONTH_AS_SECS = 30 * DAY_AS_SECS;
+var YEAR_AS_SECS = 365 * DAY_AS_SECS;
+function dateStringOrNullToUnixMs(isoString) {
+  if (!isoString) return null;
+  const unixMs = new Date(isoString).getTime();
+  if (isNaN(unixMs)) return null;
+  return unixMs;
+}
+function msToTimeString(ms, format, hoursMinLength = 2) {
+  const { hours, minutes, seconds, milliseconds } = msToDurationObj(ms);
+  const hoursString = padTimeVal(hours, hoursMinLength);
+  const minutesString = padTimeVal(minutes);
+  if (format === "minutes") {
+    return `${hoursString}:${minutesString}`;
+  }
+  const secondsString = padTimeVal(seconds);
+  if (format === "seconds") {
+    return `${hoursString}:${minutesString}:${secondsString}`;
+  }
+  return `${hoursString}:${minutesString}:${secondsString}:${padTimeVal(
+    milliseconds,
+    3
+  )}`;
+}
+function padTimeVal(val, maxLength = 2) {
+  return val.toString().padStart(maxLength, "0");
+}
+function parseTimeStringToMs(timeString) {
+  if (!timeString.trim()) return 0;
+  const [hours, minutes, seconds, ms] = timeString.split(":");
+  return getTimeStringPartToInt(hours) * HOUR_AS_MS + clampMax(getTimeStringPartToInt(minutes), 59) * MINUTE_AS_MS + clampMax(getTimeStringPartToInt(seconds), 59) * 1e3 + getTimeStringPartToInt(ms, 3);
+}
+function getTimeStringPartToInt(timeStringPart, length) {
+  if (!timeStringPart?.trim()) return 0;
+  let string = timeStringPart.replaceAll("_", "0");
+  string = string.replaceAll("-", "");
+  if (length) {
+    string = string.padEnd(length, "0");
+    if (string.length > length) {
+      string = string.slice(0, length);
+    }
+  }
+  const num = castToNumber(string);
+  if (!num) return 0;
+  return Math.floor(num);
+}
+function msToDurationObj(ms) {
+  return {
+    milliseconds: ms % 1e3,
+    seconds: Math.floor(ms / 1e3) % 60,
+    minutes: Math.floor(ms / 1e3 / 60) % 60,
+    hours: Math.floor(ms / 1e3 / 60 / 60)
+  };
+}
+function getUnixSeconds() {
+  return Math.floor(Date.now() / 1e3);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DAY_AS_MS,
+  DAY_AS_SECS,
+  HOUR_AS_MS,
+  HOUR_AS_SECS,
+  MINUTE_AS_MS,
+  MONTH_AS_MS,
+  MONTH_AS_SECS,
+  WEEK_AS_MS,
+  WEEK_AS_SECS,
+  YEAR_AS_MS,
+  YEAR_AS_SECS,
+  dateStringOrNullToUnixMs,
+  getUnixSeconds,
+  msToTimeString,
+  parseTimeStringToMs
+});

package/dist/time.d.cts

@@ -0,0 +1,17 @@
+declare const MINUTE_AS_MS: number;
+declare const HOUR_AS_MS: number;
+declare const DAY_AS_MS: number;
+declare const WEEK_AS_MS: number;
+declare const MONTH_AS_MS: number;
+declare const YEAR_AS_MS: number;
+declare const HOUR_AS_SECS: number;
+declare const DAY_AS_SECS: number;
+declare const WEEK_AS_SECS: number;
+declare const MONTH_AS_SECS: number;
+declare const YEAR_AS_SECS: number;
+declare function dateStringOrNullToUnixMs(isoString: string | null | undefined): number | null;
+declare function msToTimeString(ms: number, format: 'minutes' | 'seconds' | 'milliseconds', hoursMinLength?: number): string;
+declare function parseTimeStringToMs(timeString: string): number;
+declare function getUnixSeconds(): number;
+
+export { DAY_AS_MS, DAY_AS_SECS, HOUR_AS_MS, HOUR_AS_SECS, MINUTE_AS_MS, MONTH_AS_MS, MONTH_AS_SECS, WEEK_AS_MS, WEEK_AS_SECS, YEAR_AS_MS, YEAR_AS_SECS, dateStringOrNullToUnixMs, getUnixSeconds, msToTimeString, parseTimeStringToMs };

package/dist/time.d.ts

@@ -0,0 +1,17 @@
+declare const MINUTE_AS_MS: number;
+declare const HOUR_AS_MS: number;
+declare const DAY_AS_MS: number;
+declare const WEEK_AS_MS: number;
+declare const MONTH_AS_MS: number;
+declare const YEAR_AS_MS: number;
+declare const HOUR_AS_SECS: number;
+declare const DAY_AS_SECS: number;
+declare const WEEK_AS_SECS: number;
+declare const MONTH_AS_SECS: number;
+declare const YEAR_AS_SECS: number;
+declare function dateStringOrNullToUnixMs(isoString: string | null | undefined): number | null;
+declare function msToTimeString(ms: number, format: 'minutes' | 'seconds' | 'milliseconds', hoursMinLength?: number): string;
+declare function parseTimeStringToMs(timeString: string): number;
+declare function getUnixSeconds(): number;
+
+export { DAY_AS_MS, DAY_AS_SECS, HOUR_AS_MS, HOUR_AS_SECS, MINUTE_AS_MS, MONTH_AS_MS, MONTH_AS_SECS, WEEK_AS_MS, WEEK_AS_SECS, YEAR_AS_MS, YEAR_AS_SECS, dateStringOrNullToUnixMs, getUnixSeconds, msToTimeString, parseTimeStringToMs };

package/dist/time.js

@@ -0,0 +1,91 @@
+import {
+  clampMax
+} from "./chunk-HTCYUMDR.js";
+import {
+  castToNumber
+} from "./chunk-GBFS2I67.js";
+
+// src/time.ts
+var MINUTE_AS_MS = 60 * 1e3;
+var HOUR_AS_MS = 60 * MINUTE_AS_MS;
+var DAY_AS_MS = 24 * HOUR_AS_MS;
+var WEEK_AS_MS = 7 * DAY_AS_MS;
+var MONTH_AS_MS = 30 * DAY_AS_MS;
+var YEAR_AS_MS = 365 * DAY_AS_MS;
+var HOUR_AS_SECS = 60 * 60;
+var DAY_AS_SECS = 24 * HOUR_AS_SECS;
+var WEEK_AS_SECS = 7 * DAY_AS_SECS;
+var MONTH_AS_SECS = 30 * DAY_AS_SECS;
+var YEAR_AS_SECS = 365 * DAY_AS_SECS;
+function dateStringOrNullToUnixMs(isoString) {
+  if (!isoString) return null;
+  const unixMs = new Date(isoString).getTime();
+  if (isNaN(unixMs)) return null;
+  return unixMs;
+}
+function msToTimeString(ms, format, hoursMinLength = 2) {
+  const { hours, minutes, seconds, milliseconds } = msToDurationObj(ms);
+  const hoursString = padTimeVal(hours, hoursMinLength);
+  const minutesString = padTimeVal(minutes);
+  if (format === "minutes") {
+    return `${hoursString}:${minutesString}`;
+  }
+  const secondsString = padTimeVal(seconds);
+  if (format === "seconds") {
+    return `${hoursString}:${minutesString}:${secondsString}`;
+  }
+  return `${hoursString}:${minutesString}:${secondsString}:${padTimeVal(
+    milliseconds,
+    3
+  )}`;
+}
+function padTimeVal(val, maxLength = 2) {
+  return val.toString().padStart(maxLength, "0");
+}
+function parseTimeStringToMs(timeString) {
+  if (!timeString.trim()) return 0;
+  const [hours, minutes, seconds, ms] = timeString.split(":");
+  return getTimeStringPartToInt(hours) * HOUR_AS_MS + clampMax(getTimeStringPartToInt(minutes), 59) * MINUTE_AS_MS + clampMax(getTimeStringPartToInt(seconds), 59) * 1e3 + getTimeStringPartToInt(ms, 3);
+}
+function getTimeStringPartToInt(timeStringPart, length) {
+  if (!timeStringPart?.trim()) return 0;
+  let string = timeStringPart.replaceAll("_", "0");
+  string = string.replaceAll("-", "");
+  if (length) {
+    string = string.padEnd(length, "0");
+    if (string.length > length) {
+      string = string.slice(0, length);
+    }
+  }
+  const num = castToNumber(string);
+  if (!num) return 0;
+  return Math.floor(num);
+}
+function msToDurationObj(ms) {
+  return {
+    milliseconds: ms % 1e3,
+    seconds: Math.floor(ms / 1e3) % 60,
+    minutes: Math.floor(ms / 1e3 / 60) % 60,
+    hours: Math.floor(ms / 1e3 / 60 / 60)
+  };
+}
+function getUnixSeconds() {
+  return Math.floor(Date.now() / 1e3);
+}
+export {
+  DAY_AS_MS,
+  DAY_AS_SECS,
+  HOUR_AS_MS,
+  HOUR_AS_SECS,
+  MINUTE_AS_MS,
+  MONTH_AS_MS,
+  MONTH_AS_SECS,
+  WEEK_AS_MS,
+  WEEK_AS_SECS,
+  YEAR_AS_MS,
+  YEAR_AS_SECS,
+  dateStringOrNullToUnixMs,
+  getUnixSeconds,
+  msToTimeString,
+  parseTimeStringToMs
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ls-stack/utils",
   "description": "Typescript utils",
-  "version": "2.7.0",
+  "version": "2.8.0",
   "license": "MIT",
   "files": [
     "dist"
@@ -159,6 +159,11 @@
       "types": "./dist/testUtils.d.ts",
       "require": "./dist/testUtils.cjs"
     },
+    "./time": {
+      "import": "./dist/time.js",
+      "types": "./dist/time.d.ts",
+      "require": "./dist/time.cjs"
+    },
     "./typingFnUtils": {
       "import": "./dist/typingFnUtils.js",
       "types": "./dist/typingFnUtils.d.ts",
@@ -291,6 +296,9 @@
       "testUtils": [
         "./dist/testUtils.d.ts"
       ],
+      "time": [
+        "./dist/time.d.ts"
+      ],
       "typingFnUtils": [
         "./dist/typingFnUtils.d.ts"
       ],