@ls-stack/utils 2.14.0 → 3.1.0

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-2TIVYE43.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-2TIVYE43.js";
 
 // src/interpolate.ts
 function mod(n, m) {

package/dist/main.d.ts

@@ -10,7 +10,7 @@
 ///<reference path="deepEqual.d.ts" />
 ///<reference path="enhancedMap.d.ts" />
 ///<reference path="exhaustiveMatch.d.ts" />
-///<reference path="getObjStableKey.d.ts" />
+///<reference path="getValueStableKey.d.ts" />
 ///<reference path="internalUtils.d.ts" />
 ///<reference path="interpolate.d.ts" />
 ///<reference path="levenshtein.d.ts" />
@@ -20,7 +20,6 @@
 ///<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 +27,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" />

package/dist/parallelAsyncCalls.cjs

@@ -34,6 +34,11 @@ function isObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
+// src/sleep.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
 // src/safeJson.ts
 function safeJsonStringify(value) {
   try {
@@ -43,7 +48,7 @@ function safeJsonStringify(value) {
   }
 }
 
-// src/rsResult.ts
+// src/tsResult.ts
 function okUnwrapOr() {
   return this.value;
 }
@@ -62,28 +67,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;
@@ -92,7 +109,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) {
@@ -132,7 +159,8 @@ var Result = {
   err,
   unknownToError: unknownToResultError,
   asyncUnwrap,
-  asyncMap
+  asyncMap,
+  getOkErr
 };
 function unknownToError(error) {
   if (error instanceof Error) return error;
@@ -149,10 +177,15 @@ function unknownToError(error) {
     cause: error
   });
 }
-
-// src/sleep.ts
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
+var typedResult = {
+  ok,
+  err,
+  get _type() {
+    throw new Error("usage as value is not allowed");
+  }
+};
+function getOkErr() {
+  return typedResult;
 }
 
 // src/parallelAsyncCalls.ts

package/dist/parallelAsyncCalls.d.cts

@@ -1,5 +1,4 @@
-import { Result } from './rsResult.cjs';
-import './safeJson.cjs';
+import { Result } from './tsResult.cjs';
 
 type ValidMetadata = string | number | boolean | Record<string, unknown>;
 type TupleRunAllSuccess<T> = T extends () => Promise<Result<infer V>> ? Succeeded<V, undefined> : T extends {

package/dist/parallelAsyncCalls.d.ts

@@ -1,5 +1,4 @@
-import { Result } from './rsResult.js';
-import './safeJson.js';
+import { Result } from './tsResult.js';
 
 type ValidMetadata = string | number | boolean | Record<string, unknown>;
 type TupleRunAllSuccess<T> = T extends () => Promise<Result<infer V>> ? Succeeded<V, undefined> : T extends {

package/dist/parallelAsyncCalls.js

@@ -1,15 +1,15 @@
-import {
-  sleep
-} from "./chunk-5DZT3Z5Z.js";
 import {
   Result,
   unknownToError
-} from "./chunk-KBFP7INB.js";
+} from "./chunk-55DQGPY3.js";
+import {
+  sleep
+} from "./chunk-5DZT3Z5Z.js";
 import "./chunk-VAAMRG4K.js";
 import {
   invariant,
   isObject
-} from "./chunk-4UGSP3L3.js";
+} from "./chunk-2TIVYE43.js";
 
 // src/parallelAsyncCalls.ts
 var ParallelAsyncResultCalls = class {

package/dist/testUtils.js

@@ -14,7 +14,7 @@ import {
 } from "./chunk-HTCYUMDR.js";
 import {
   isObject
-} from "./chunk-4UGSP3L3.js";
+} from "./chunk-2TIVYE43.js";
 
 // src/testUtils.ts
 function createLoggerStore({

package/dist/time.cjs

@@ -41,11 +41,19 @@ module.exports = __toCommonJS(time_exports);
 
 // src/castValues.ts
 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;
+  }
 }
 
 // src/mathUtils.ts

package/dist/time.js

@@ -15,9 +15,9 @@ import {
   getUnixSeconds,
   msToTimeString,
   parseTimeStringToMs
-} from "./chunk-RK6PT7JY.js";
+} from "./chunk-5MNYPLZI.js";
 import "./chunk-HTCYUMDR.js";
-import "./chunk-GBFS2I67.js";
+import "./chunk-II4R3VVX.js";
 export {
   DAY_AS_MS,
   DAY_AS_SECS,

package/dist/{rsResult.cjs → tsResult.cjs}

@@ -17,23 +17,27 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/rsResult.ts
-var rsResult_exports = {};
-__export(rsResult_exports, {
+// src/tsResult.ts
+var tsResult_exports = {};
+__export(tsResult_exports, {
   Result: () => Result,
-  asyncResultify: () => asyncResultify,
-  createTypedResult: () => createTypedResult,
-  normalizeError: () => normalizeError,
+  err: () => err,
+  ok: () => ok,
   resultify: () => resultify,
-  safeJsonStringify: () => safeJsonStringify2,
   unknownToError: () => unknownToError
 });
-module.exports = __toCommonJS(rsResult_exports);
+module.exports = __toCommonJS(tsResult_exports);
 
 // src/assertions.ts
 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 && isFunction(value.then);
+}
 
 // src/safeJson.ts
 function safeJsonStringify(value) {
@@ -44,7 +48,7 @@ function safeJsonStringify(value) {
   }
 }
 
-// src/rsResult.ts
+// src/tsResult.ts
 function okUnwrapOr() {
   return this.value;
 }
@@ -63,28 +67,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;
@@ -93,7 +109,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) {
@@ -133,20 +159,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)
@@ -168,23 +201,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;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Result,
-  asyncResultify,
-  createTypedResult,
-  normalizeError,
+  err,
+  ok,
   resultify,
-  safeJsonStringify,
   unknownToError
 });