@ls-stack/utils 2.14.1 → 3.2.0

package/dist/assertions.cjs

@@ -34,15 +34,15 @@ __export(assertions_exports, {
 module.exports = __toCommonJS(assertions_exports);
 var undefErrMsg = "not undefined assertion failed";
 var nullishErrMsg = "not nullish assertion failed";
-function notUndefined(value) {
+function notUndefined(value, errorMsg = undefErrMsg) {
   if (value === void 0) {
-    throw new Error(undefErrMsg);
+    throw new Error(errorMsg);
   }
   return value;
 }
-function notNullish(value) {
+function notNullish(value, errorMsg = nullishErrMsg) {
   if (value === void 0 || value === null) {
-    throw new Error(nullishErrMsg);
+    throw new Error(errorMsg);
   }
   return value;
 }
@@ -71,7 +71,7 @@ function isFunction(value) {
   return typeof value === "function";
 }
 function isPromise(value) {
-  return isObject(value) && "then" in value;
+  return isObject(value) && "then" in value && isFunction(value.then);
 }
 function isPlainObject(value) {
   if (!value || typeof value !== "object") return false;

package/dist/assertions.d.cts

@@ -1,8 +1,8 @@
 type NotUndefined<T> = T extends undefined ? never : T;
 type StrictNonUndefined<T, N = unknown> = undefined extends T ? NotUndefined<T> : N;
-declare function notUndefined<T>(value: T): StrictNonUndefined<T>;
+declare function notUndefined<T>(value: T, errorMsg?: string): StrictNonUndefined<T>;
 type StrictNonNullable<T, N = unknown> = undefined extends T ? NonNullable<T> : null extends T ? NonNullable<T> : N;
-declare function notNullish<T>(value: T): StrictNonNullable<T>;
+declare function notNullish<T>(value: T, errorMsg?: string): StrictNonNullable<T>;
 declare function assertIsNotNullish<T>(value: T, errorMsg?: string): asserts value is StrictNonNullable<T, never>;
 declare function assertIsNotUndefined<T>(value: T, errorMsg?: string): asserts value is StrictNonUndefined<T, never>;
 /** Use this function to assert that a certain condition is always true. */

package/dist/assertions.d.ts

@@ -1,8 +1,8 @@
 type NotUndefined<T> = T extends undefined ? never : T;
 type StrictNonUndefined<T, N = unknown> = undefined extends T ? NotUndefined<T> : N;
-declare function notUndefined<T>(value: T): StrictNonUndefined<T>;
+declare function notUndefined<T>(value: T, errorMsg?: string): StrictNonUndefined<T>;
 type StrictNonNullable<T, N = unknown> = undefined extends T ? NonNullable<T> : null extends T ? NonNullable<T> : N;
-declare function notNullish<T>(value: T): StrictNonNullable<T>;
+declare function notNullish<T>(value: T, errorMsg?: string): StrictNonNullable<T>;
 declare function assertIsNotNullish<T>(value: T, errorMsg?: string): asserts value is StrictNonNullable<T, never>;
 declare function assertIsNotUndefined<T>(value: T, errorMsg?: string): asserts value is StrictNonUndefined<T, never>;
 /** Use this function to assert that a certain condition is always true. */

package/dist/assertions.js

@@ -9,7 +9,7 @@ import {
   isPromise,
   notNullish,
   notUndefined
-} from "./chunk-4UGSP3L3.js";
+} from "./chunk-3XCS7FVO.js";
 export {
   assertIsNotNullish,
   assertIsNotUndefined,

package/dist/cache.cjs

@@ -31,8 +31,11 @@ module.exports = __toCommonJS(cache_exports);
 function isObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function isFunction(value) {
+  return typeof value === "function";
+}
 function isPromise(value) {
-  return isObject(value) && "then" in value;
+  return isObject(value) && "then" in value && isFunction(value.then);
 }
 
 // src/time.ts

package/dist/cache.js

@@ -1,11 +1,11 @@
 import {
   durationObjToMs
-} from "./chunk-RK6PT7JY.js";
+} from "./chunk-5MNYPLZI.js";
 import "./chunk-HTCYUMDR.js";
 import {
   isPromise
-} from "./chunk-4UGSP3L3.js";
-import "./chunk-GBFS2I67.js";
+} from "./chunk-3XCS7FVO.js";
+import "./chunk-II4R3VVX.js";
 
 // src/cache.ts
 function cachedGetter(getter) {

package/dist/castValues.cjs

@@ -29,11 +29,19 @@ function castToString(value) {
   return valueType === "string" || valueType === "number" || valueType === "boolean" || valueType === "bigint" ? String(value) : null;
 }
 function castToNumber(value) {
-  return isNumeric(value) ? Number(value) : null;
+  return isFiniteNumeric(value) ? Number(value) : null;
 }
-function isNumeric(num) {
-  const str = String(num);
-  return !isNaN(str) && !isNaN(parseFloat(str));
+function isFiniteNumeric(num) {
+  switch (typeof num) {
+    case "number":
+      return num - num === 0;
+    case "string":
+      return num.trim() !== "" && Number.isFinite(+num);
+    case "bigint":
+      return Number.isFinite(Number(num));
+    default:
+      return false;
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/castValues.js

@@ -1,7 +1,7 @@
 import {
   castToNumber,
   castToString
-} from "./chunk-GBFS2I67.js";
+} from "./chunk-II4R3VVX.js";
 export {
   castToNumber,
   castToString

package/dist/{chunk-4UGSP3L3.js → chunk-3XCS7FVO.js}

@@ -1,15 +1,15 @@
 // src/assertions.ts
 var undefErrMsg = "not undefined assertion failed";
 var nullishErrMsg = "not nullish assertion failed";
-function notUndefined(value) {
+function notUndefined(value, errorMsg = undefErrMsg) {
   if (value === void 0) {
-    throw new Error(undefErrMsg);
+    throw new Error(errorMsg);
   }
   return value;
 }
-function notNullish(value) {
+function notNullish(value, errorMsg = nullishErrMsg) {
   if (value === void 0 || value === null) {
-    throw new Error(nullishErrMsg);
+    throw new Error(errorMsg);
   }
   return value;
 }
@@ -38,7 +38,7 @@ function isFunction(value) {
   return typeof value === "function";
 }
 function isPromise(value) {
-  return isObject(value) && "then" in value;
+  return isObject(value) && "then" in value && isFunction(value.then);
 }
 function isPlainObject(value) {
   if (!value || typeof value !== "object") return false;

package/dist/{chunk-RK6PT7JY.js → chunk-5MNYPLZI.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-HTCYUMDR.js";
 import {
   castToNumber
-} from "./chunk-GBFS2I67.js";
+} from "./chunk-II4R3VVX.js";
 
 // src/time.ts
 var MINUTE_AS_MS = 60 * 1e3;

package/dist/chunk-II4R3VVX.js

@@ -0,0 +1,25 @@
+// 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 isFiniteNumeric(value) ? Number(value) : null;
+}
+function isFiniteNumeric(num) {
+  switch (typeof num) {
+    case "number":
+      return num - num === 0;
+    case "string":
+      return num.trim() !== "" && Number.isFinite(+num);
+    case "bigint":
+      return Number.isFinite(Number(num));
+    default:
+      return false;
+  }
+}
+
+export {
+  castToString,
+  castToNumber
+};

package/dist/{chunk-KBFP7INB.js → chunk-J73KJABC.js}

@@ -2,10 +2,12 @@ import {
   safeJsonStringify
 } from "./chunk-VAAMRG4K.js";
 import {
-  isObject
-} from "./chunk-4UGSP3L3.js";
+  isFunction,
+  isObject,
+  isPromise
+} from "./chunk-3XCS7FVO.js";
 
-// src/rsResult.ts
+// src/tsResult.ts
 function okUnwrapOr() {
   return this.value;
 }
@@ -24,28 +26,40 @@ function mapOkAndErr({
 function returnResult() {
   return this;
 }
+function okOnOk(fn) {
+  if (this.ok) {
+    fn(this.value);
+  }
+  return this;
+}
+function errOnErr(fn) {
+  if (!this.ok) {
+    fn(this.error);
+  }
+  return this;
+}
 function ok(value = void 0) {
-  return {
-    ok: true,
-    error: false,
-    value,
+  const methods = {
     unwrapOrNull: okUnwrapOr,
     unwrapOr: okUnwrapOr,
     unwrap: okUnwrapOr,
     mapOk: okMap,
     mapErr: returnResult,
-    mapOkAndErr
+    mapOkAndErr,
+    ifOk: okOnOk,
+    ifErr: returnResult
+  };
+  return {
+    ok: true,
+    error: false,
+    value,
+    ...methods
   };
 }
 function err(error) {
-  return {
-    ok: false,
-    error,
+  const methods = {
     unwrapOrNull: () => null,
     unwrapOr: (defaultValue) => defaultValue,
-    errorResult() {
-      return err(error);
-    },
     unwrap: () => {
       if (error instanceof Error) {
         throw error;
@@ -54,7 +68,17 @@ function err(error) {
     },
     mapOk: returnResult,
     mapErr: errMap,
-    mapOkAndErr
+    mapOkAndErr,
+    ifOk: returnResult,
+    ifErr: errOnErr
+  };
+  return {
+    ok: false,
+    error,
+    errorResult() {
+      return err(error);
+    },
+    ...methods
   };
 }
 function unknownToResultError(error) {
@@ -94,20 +118,27 @@ var Result = {
   err,
   unknownToError: unknownToResultError,
   asyncUnwrap,
-  asyncMap
+  asyncMap,
+  getOkErr
 };
 function resultify(fn, errorNormalizer) {
-  try {
-    return ok(fn());
-  } catch (error) {
-    return err(
-      errorNormalizer ? errorNormalizer(error) : unknownToError(error)
+  if (!isFunction(fn)) {
+    return fn.then((value) => ok(value)).catch(
+      (error) => err(
+        errorNormalizer ? errorNormalizer(error) : unknownToError(error)
+      )
     );
   }
-}
-async function asyncResultify(fn, errorNormalizer) {
   try {
-    return ok(await fn());
+    const result = fn();
+    if (isPromise(result)) {
+      return result.then((value) => ok(value)).catch(
+        (error) => err(
+          errorNormalizer ? errorNormalizer(error) : unknownToError(error)
+        )
+      );
+    }
+    return ok(result);
   } catch (error) {
     return err(
       errorNormalizer ? errorNormalizer(error) : unknownToError(error)
@@ -129,23 +160,21 @@ function unknownToError(error) {
     cause: error
   });
 }
-function normalizeError(error) {
-  return unknownToError(error);
-}
-var safeJsonStringify2 = safeJsonStringify;
-function createTypedResult() {
-  return {
-    ok,
-    err
-  };
+var typedResult = {
+  ok,
+  err,
+  get _type() {
+    throw new Error("usage as value is not allowed");
+  }
+};
+function getOkErr() {
+  return typedResult;
 }
 
 export {
+  ok,
+  err,
   Result,
   resultify,
-  asyncResultify,
-  unknownToError,
-  normalizeError,
-  safeJsonStringify2 as safeJsonStringify,
-  createTypedResult
+  unknownToError
 };

package/dist/{chunk-T5WDDPFI.js → chunk-OHHF4CJZ.js}

@@ -1,6 +1,6 @@
 import {
   isFunction
-} from "./chunk-4UGSP3L3.js";
+} from "./chunk-3XCS7FVO.js";
 
 // src/enhancedMap.ts
 var enhancedMapReject = Symbol();

package/dist/createThrottleController.js

@@ -1,12 +1,12 @@
 import {
   EnhancedMap
-} from "./chunk-T5WDDPFI.js";
+} from "./chunk-OHHF4CJZ.js";
 import {
   durationObjToMs
-} from "./chunk-RK6PT7JY.js";
+} from "./chunk-5MNYPLZI.js";
 import "./chunk-HTCYUMDR.js";
-import "./chunk-4UGSP3L3.js";
-import "./chunk-GBFS2I67.js";
+import "./chunk-3XCS7FVO.js";
+import "./chunk-II4R3VVX.js";
 
 // src/createThrottleController.ts
 function createThrottleController({

package/dist/enhancedMap.js

@@ -1,8 +1,8 @@
 import {
   EnhancedMap,
   enhancedMapReject
-} from "./chunk-T5WDDPFI.js";
-import "./chunk-4UGSP3L3.js";
+} from "./chunk-OHHF4CJZ.js";
+import "./chunk-3XCS7FVO.js";
 export {
   EnhancedMap,
   enhancedMapReject

package/dist/exhaustiveMatch.cjs

@@ -20,7 +20,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/exhaustiveMatch.ts
 var exhaustiveMatch_exports = {};
 __export(exhaustiveMatch_exports, {
-  exhaustiveMatch: () => exhaustiveMatch
+  exhaustiveMatch: () => exhaustiveMatch,
+  exhaustiveMatchObjUnion: () => exhaustiveMatchObjUnion
 });
 module.exports = __toCommonJS(exhaustiveMatch_exports);
 function exhaustiveMatch(value) {
@@ -49,7 +50,17 @@ function exhaustiveMatch(value) {
     withObject
   };
 }
+function exhaustiveMatchObjUnion(obj, key) {
+  function withLazy(pattern) {
+    const result = pattern[obj[key]];
+    if (typeof result === "function")
+      return result(obj);
+    throw new Error(`Exhaustive match failed: no match for ${obj[key]}`);
+  }
+  return { with: withLazy };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  exhaustiveMatch
+  exhaustiveMatch,
+  exhaustiveMatchObjUnion
 });

package/dist/exhaustiveMatch.d.cts

@@ -2,5 +2,8 @@ declare function exhaustiveMatch<T extends string>(value: T): {
     with: <R>(pattern: { [K in T]: "_nxt" | "_never" | (() => R); }) => R;
     withObject: <R>(pattern: Record<T, R>) => R;
 };
+declare function exhaustiveMatchObjUnion<T extends Record<string, unknown>, D extends keyof T, K extends T[D] & string>(obj: T, key: D): {
+    with: <R>(pattern: { [P in K]: "_never" | ((props: Extract<T, Record<D, P>>) => R); }) => R;
+};
 
-export { exhaustiveMatch };
+export { exhaustiveMatch, exhaustiveMatchObjUnion };

package/dist/exhaustiveMatch.d.ts

@@ -2,5 +2,8 @@ declare function exhaustiveMatch<T extends string>(value: T): {
     with: <R>(pattern: { [K in T]: "_nxt" | "_never" | (() => R); }) => R;
     withObject: <R>(pattern: Record<T, R>) => R;
 };
+declare function exhaustiveMatchObjUnion<T extends Record<string, unknown>, D extends keyof T, K extends T[D] & string>(obj: T, key: D): {
+    with: <R>(pattern: { [P in K]: "_never" | ((props: Extract<T, Record<D, P>>) => R); }) => R;
+};
 
-export { exhaustiveMatch };
+export { exhaustiveMatch, exhaustiveMatchObjUnion };

package/dist/exhaustiveMatch.js

@@ -25,6 +25,16 @@ function exhaustiveMatch(value) {
     withObject
   };
 }
+function exhaustiveMatchObjUnion(obj, key) {
+  function withLazy(pattern) {
+    const result = pattern[obj[key]];
+    if (typeof result === "function")
+      return result(obj);
+    throw new Error(`Exhaustive match failed: no match for ${obj[key]}`);
+  }
+  return { with: withLazy };
+}
 export {
-  exhaustiveMatch
+  exhaustiveMatch,
+  exhaustiveMatchObjUnion
 };

package/dist/getValueStableKey.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/getValueStableKey.ts
+var getValueStableKey_exports = {};
+__export(getValueStableKey_exports, {
+  getValueStableKey: () => getValueStableKey
+});
+module.exports = __toCommonJS(getValueStableKey_exports);
+
+// src/assertions.ts
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+// src/getValueStableKey.ts
+function getValueStableKey(input, maxSortingDepth = 3) {
+  if (typeof input === "string") return `"${input}`;
+  if (!input || typeof input !== "object") return `$${input}`;
+  return stringifyCompact(input, maxSortingDepth, 0, /* @__PURE__ */ new WeakSet());
+}
+function stringifyCompact(input, maxSortingDepth, depth, refs) {
+  const isJsObj = input && typeof input === "object";
+  if (isJsObj) {
+    if (refs.has(input)) {
+      throw new Error("Circular reference detected");
+    }
+    refs.add(input);
+  }
+  let result;
+  if (Array.isArray(input)) {
+    result = "[";
+    for (const v of input) {
+      if (result.length > 1) result += ",";
+      result += stringifyCompact(v, maxSortingDepth, depth + 1, refs);
+    }
+    result += "]";
+  } else if (isObject(input)) {
+    let entries = Object.entries(input);
+    if (entries.length === 0) {
+      result = "{}";
+    } else {
+      if (depth < maxSortingDepth) {
+        entries = entries.sort(
+          ([a], [b]) => a < b ? -1 : a > b ? 1 : 0
+        );
+      }
+      result = "{";
+      for (const [k, v] of entries) {
+        if (v === void 0) continue;
+        if (result.length > 1) result += ",";
+        result += `${k}:${stringifyCompact(v, maxSortingDepth, depth + 1, refs)}`;
+      }
+      result += "}";
+    }
+  } else {
+    result = JSON.stringify(input);
+  }
+  if (isJsObj) {
+    refs.delete(input);
+  }
+  return result;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getValueStableKey
+});

package/dist/getValueStableKey.d.cts

@@ -0,0 +1,10 @@
+/**
+ * Returns a stable key for the input value.
+ *
+ * @param input - The value to get a stable key for.
+ * @param maxSortingDepth - The maximum depth to sort the input value. Default is 3.
+ * @returns A stable key for the input value.
+ */
+declare function getValueStableKey(input: unknown, maxSortingDepth?: number): string;
+
+export { getValueStableKey };

package/dist/getValueStableKey.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Returns a stable key for the input value.
+ *
+ * @param input - The value to get a stable key for.
+ * @param maxSortingDepth - The maximum depth to sort the input value. Default is 3.
+ * @returns A stable key for the input value.
+ */
+declare function getValueStableKey(input: unknown, maxSortingDepth?: number): string;
+
+export { getValueStableKey };

package/dist/getValueStableKey.js

@@ -0,0 +1,55 @@
+import {
+  isObject
+} from "./chunk-3XCS7FVO.js";
+
+// src/getValueStableKey.ts
+function getValueStableKey(input, maxSortingDepth = 3) {
+  if (typeof input === "string") return `"${input}`;
+  if (!input || typeof input !== "object") return `$${input}`;
+  return stringifyCompact(input, maxSortingDepth, 0, /* @__PURE__ */ new WeakSet());
+}
+function stringifyCompact(input, maxSortingDepth, depth, refs) {
+  const isJsObj = input && typeof input === "object";
+  if (isJsObj) {
+    if (refs.has(input)) {
+      throw new Error("Circular reference detected");
+    }
+    refs.add(input);
+  }
+  let result;
+  if (Array.isArray(input)) {
+    result = "[";
+    for (const v of input) {
+      if (result.length > 1) result += ",";
+      result += stringifyCompact(v, maxSortingDepth, depth + 1, refs);
+    }
+    result += "]";
+  } else if (isObject(input)) {
+    let entries = Object.entries(input);
+    if (entries.length === 0) {
+      result = "{}";
+    } else {
+      if (depth < maxSortingDepth) {
+        entries = entries.sort(
+          ([a], [b]) => a < b ? -1 : a > b ? 1 : 0
+        );
+      }
+      result = "{";
+      for (const [k, v] of entries) {
+        if (v === void 0) continue;
+        if (result.length > 1) result += ",";
+        result += `${k}:${stringifyCompact(v, maxSortingDepth, depth + 1, refs)}`;
+      }
+      result += "}";
+    }
+  } else {
+    result = JSON.stringify(input);
+  }
+  if (isJsObj) {
+    refs.delete(input);
+  }
+  return result;
+}
+export {
+  getValueStableKey
+};

package/dist/interpolate.js

@@ -5,7 +5,7 @@ import {
 } from "./chunk-HTCYUMDR.js";
 import {
   invariant
-} from "./chunk-4UGSP3L3.js";
+} from "./chunk-3XCS7FVO.js";
 
 // src/interpolate.ts
 function mod(n, m) {

package/dist/main.d.ts

@@ -10,17 +10,14 @@
 ///<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="getValueStableKey.d.ts" />
 ///<reference path="interpolate.d.ts" />
 ///<reference path="levenshtein.d.ts" />
-///<reference path="main.d.ts" />
 ///<reference path="mathUtils.d.ts" />
 ///<reference path="objUtils.d.ts" />
 ///<reference path="parallelAsyncCalls.d.ts" />
 ///<reference path="promiseUtils.d.ts" />
 ///<reference path="retryOnError.d.ts" />
-///<reference path="rsResult.d.ts" />
 ///<reference path="runShellCmd.d.ts" />
 ///<reference path="safeJson.d.ts" />
 ///<reference path="shallowEqual.d.ts" />
@@ -28,6 +25,7 @@
 ///<reference path="stringUtils.d.ts" />
 ///<reference path="testUtils.d.ts" />
 ///<reference path="time.d.ts" />
+///<reference path="tsResult.d.ts" />
 ///<reference path="typingFnUtils.d.ts" />
 ///<reference path="typingTestUtils.d.ts" />
 ///<reference path="typingUtils.d.ts" />