@ls-stack/utils 2.7.0 → 2.9.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/getObjStableKey.cjs

@@ -0,0 +1,83 @@
+"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/getObjStableKey.ts
+var getObjStableKey_exports = {};
+__export(getObjStableKey_exports, {
+  getObjStableKey: () => getObjStableKey
+});
+module.exports = __toCommonJS(getObjStableKey_exports);
+
+// src/arrayUtils.ts
+function filterAndMap(array, mapFilter) {
+  const result = [];
+  let i = -1;
+  for (const item of array) {
+    i += 1;
+    const filterResult = mapFilter(item, i);
+    if (filterResult !== false) {
+      result.push(filterResult);
+    }
+  }
+  return result;
+}
+
+// src/assertions.ts
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+// src/getObjStableKey.ts
+function getObjStableKey(input, maxDepth = 3) {
+  if (typeof input === "string") return String(input);
+  if (!input || typeof input !== "object") return `#$${input}$#`;
+  return JSON.stringify(sortValues(input, maxDepth, 0));
+}
+function sortValues(input, maxDepth, depth) {
+  if (depth >= maxDepth) return input;
+  if (Array.isArray(input)) {
+    return input.map((v) => sortValues(v, maxDepth, depth + 1));
+  }
+  if (isObject(input)) {
+    return orderedProps(input, (v) => sortValues(v, maxDepth, depth + 1));
+  }
+  return input;
+}
+var emptyObject = {};
+function orderedProps(obj, mapValue) {
+  const keys = Object.keys(obj);
+  if (keys.length === 0) return emptyObject;
+  if (keys.length === 1) {
+    const value = obj[keys[0]];
+    if (value === void 0) return emptyObject;
+    return { [keys[0]]: mapValue(value) };
+  }
+  const mappedValues = filterAndMap(keys.sort(), (k) => {
+    const value = obj[k];
+    if (value === void 0) return false;
+    return { [k]: mapValue(value) };
+  });
+  if (mappedValues.length === 0) return emptyObject;
+  if (mappedValues.length === 1) return mappedValues[0];
+  return mappedValues;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getObjStableKey
+});

package/dist/getObjStableKey.d.cts

@@ -0,0 +1,3 @@
+declare function getObjStableKey(input: unknown, maxDepth?: number): string;
+
+export { getObjStableKey };

package/dist/getObjStableKey.d.ts

@@ -0,0 +1,3 @@
+declare function getObjStableKey(input: unknown, maxDepth?: number): string;
+
+export { getObjStableKey };

package/dist/getObjStableKey.js

@@ -0,0 +1,44 @@
+import {
+  filterAndMap
+} from "./chunk-QMFZE2VO.js";
+import {
+  isObject
+} from "./chunk-4UGSP3L3.js";
+
+// src/getObjStableKey.ts
+function getObjStableKey(input, maxDepth = 3) {
+  if (typeof input === "string") return String(input);
+  if (!input || typeof input !== "object") return `#$${input}$#`;
+  return JSON.stringify(sortValues(input, maxDepth, 0));
+}
+function sortValues(input, maxDepth, depth) {
+  if (depth >= maxDepth) return input;
+  if (Array.isArray(input)) {
+    return input.map((v) => sortValues(v, maxDepth, depth + 1));
+  }
+  if (isObject(input)) {
+    return orderedProps(input, (v) => sortValues(v, maxDepth, depth + 1));
+  }
+  return input;
+}
+var emptyObject = {};
+function orderedProps(obj, mapValue) {
+  const keys = Object.keys(obj);
+  if (keys.length === 0) return emptyObject;
+  if (keys.length === 1) {
+    const value = obj[keys[0]];
+    if (value === void 0) return emptyObject;
+    return { [keys[0]]: mapValue(value) };
+  }
+  const mappedValues = filterAndMap(keys.sort(), (k) => {
+    const value = obj[k];
+    if (value === void 0) return false;
+    return { [k]: mapValue(value) };
+  });
+  if (mappedValues.length === 0) return emptyObject;
+  if (mappedValues.length === 1) return mappedValues[0];
+  return mappedValues;
+}
+export {
+  getObjStableKey
+};

package/dist/main.d.ts

@@ -10,6 +10,7 @@
 ///<reference path="deepEqual.d.ts" />
 ///<reference path="enhancedMap.d.ts" />
 ///<reference path="exhaustiveMatch.d.ts" />
+///<reference path="getObjStableKey.d.ts" />
 ///<reference path="internalUtils.d.ts" />
 ///<reference path="interpolate.d.ts" />
 ///<reference path="levenshtein.d.ts" />
@@ -26,6 +27,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.9.0",
   "license": "MIT",
   "files": [
     "dist"
@@ -79,6 +79,11 @@
       "types": "./dist/exhaustiveMatch.d.ts",
       "require": "./dist/exhaustiveMatch.cjs"
     },
+    "./getObjStableKey": {
+      "import": "./dist/getObjStableKey.js",
+      "types": "./dist/getObjStableKey.d.ts",
+      "require": "./dist/getObjStableKey.cjs"
+    },
     "./internalUtils": {
       "import": "./dist/internalUtils.js",
       "types": "./dist/internalUtils.d.ts",
@@ -159,6 +164,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",
@@ -243,6 +253,9 @@
       "exhaustiveMatch": [
         "./dist/exhaustiveMatch.d.ts"
       ],
+      "getObjStableKey": [
+        "./dist/getObjStableKey.d.ts"
+      ],
       "internalUtils": [
         "./dist/internalUtils.d.ts"
       ],
@@ -291,6 +304,9 @@
       "testUtils": [
         "./dist/testUtils.d.ts"
       ],
+      "time": [
+        "./dist/time.d.ts"
+      ],
       "typingFnUtils": [
         "./dist/typingFnUtils.d.ts"
       ],