@ls-stack/utils 3.12.2 → 3.13.0

package/lib/asyncQueue.cjs

@@ -143,7 +143,9 @@ var AsyncQueue = class {
         if (signal) {
           const error = signal.reason instanceof Error ? signal.reason : new DOMException("This operation was aborted", "AbortError");
           abortListener = () => {
-            reject(error);
+            setTimeout(() => {
+              reject(error);
+            }, 0);
           };
           signal.addEventListener("abort", abortListener, { once: true });
         }

package/lib/asyncQueue.js

@@ -114,7 +114,9 @@ var AsyncQueue = class {
         if (signal) {
           const error = signal.reason instanceof Error ? signal.reason : new DOMException("This operation was aborted", "AbortError");
           abortListener = () => {
-            reject(error);
+            setTimeout(() => {
+              reject(error);
+            }, 0);
           };
           signal.addEventListener("abort", abortListener, { once: true });
         }

package/lib/chunk-U44EKR2F.js

@@ -0,0 +1,56 @@
+import {
+  isObject
+} from "./chunk-3XCS7FVO.js";
+
+// src/getCompositeKey.ts
+function getCompositeKey(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 {
+  getCompositeKey
+};

package/lib/getCompositeKey.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/getCompositeKey.ts
+var getCompositeKey_exports = {};
+__export(getCompositeKey_exports, {
+  getCompositeKey: () => getCompositeKey
+});
+module.exports = __toCommonJS(getCompositeKey_exports);
+
+// src/assertions.ts
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+// src/getCompositeKey.ts
+function getCompositeKey(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 = {
+  getCompositeKey
+});

package/lib/getCompositeKey.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 getCompositeKey(input: unknown, maxSortingDepth?: number): string;
+
+export { getCompositeKey };

package/lib/getCompositeKey.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 getCompositeKey(input: unknown, maxSortingDepth?: number): string;
+
+export { getCompositeKey };

package/lib/getCompositeKey.js

@@ -0,0 +1,7 @@
+import {
+  getCompositeKey
+} from "./chunk-U44EKR2F.js";
+import "./chunk-3XCS7FVO.js";
+export {
+  getCompositeKey
+};

package/lib/getValueStableKey.cjs

@@ -29,8 +29,8 @@ function isObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
-// src/getValueStableKey.ts
-function getValueStableKey(input, maxSortingDepth = 3) {
+// src/getCompositeKey.ts
+function getCompositeKey(input, maxSortingDepth = 3) {
   if (typeof input === "string") return `"${input}`;
   if (!input || typeof input !== "object") return `$${input}`;
   return stringifyCompact(input, maxSortingDepth, 0, /* @__PURE__ */ new WeakSet());
@@ -77,6 +77,9 @@ function stringifyCompact(input, maxSortingDepth, depth, refs) {
   }
   return result;
 }
+
+// src/getValueStableKey.ts
+var getValueStableKey = getCompositeKey;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   getValueStableKey

package/lib/getValueStableKey.d.cts

@@ -1,10 +1,14 @@
+import { getCompositeKey } from './getCompositeKey.cjs';
+
 /**
  * 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.
+ *
+ * @deprecated Use `getCompositeKey` from `@ls-stack/utils/getCompositeKey` instead.
  */
-declare function getValueStableKey(input: unknown, maxSortingDepth?: number): string;
+declare const getValueStableKey: typeof getCompositeKey;
 
 export { getValueStableKey };

package/lib/getValueStableKey.d.ts

@@ -1,10 +1,14 @@
+import { getCompositeKey } from './getCompositeKey.js';
+
 /**
  * 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.
+ *
+ * @deprecated Use `getCompositeKey` from `@ls-stack/utils/getCompositeKey` instead.
  */
-declare function getValueStableKey(input: unknown, maxSortingDepth?: number): string;
+declare const getValueStableKey: typeof getCompositeKey;
 
 export { getValueStableKey };

package/lib/getValueStableKey.js

@@ -1,55 +1,10 @@
 import {
-  isObject
-} from "./chunk-3XCS7FVO.js";
+  getCompositeKey
+} from "./chunk-U44EKR2F.js";
+import "./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;
-}
+var getValueStableKey = getCompositeKey;
 export {
   getValueStableKey
 };

package/lib/objUtils.d.cts

@@ -1,3 +1,4 @@
+/** @deprecated use typedObjectEntries from @ls-stack/utils/typingFnUtils instead */
 declare function objectTypedEntries<T extends Record<string, unknown>>(obj: T): [Extract<keyof T, string>, T[keyof T]][];
 declare function pick<T, K extends keyof T>(obj: T | undefined, keys: K[], rename?: Partial<Record<K, string>>): Record<string, unknown>;
 declare function mapArrayToObject<T, K extends string, O>(array: T[], mapper: (item: T, index: number) => [K, O]): Record<K, O>;

package/lib/objUtils.d.ts

@@ -1,3 +1,4 @@
+/** @deprecated use typedObjectEntries from @ls-stack/utils/typingFnUtils instead */
 declare function objectTypedEntries<T extends Record<string, unknown>>(obj: T): [Extract<keyof T, string>, T[keyof T]][];
 declare function pick<T, K extends keyof T>(obj: T | undefined, keys: K[], rename?: Partial<Record<K, string>>): Record<string, unknown>;
 declare function mapArrayToObject<T, K extends string, O>(array: T[], mapper: (item: T, index: number) => [K, O]): Record<K, O>;

package/lib/saferTyping.d.cts

@@ -1,5 +1,10 @@
 /** Use this only when you have 100% of certainty that this will not break the types */
 type __LEGIT_ANY__ = any;
+type __LEGIT_ANY_FUNCTION__ = (...params: any) => __LEGIT_ANY__;
+/**
+ * An empty object type, equivalent to `{}` but with safer typing
+ */
+type EmptyObject = Record<string, never>;
 /**
  * Cast a value to `any` type. Use this when you have legit usage of `any` casting.
  *
@@ -23,5 +28,10 @@ declare function __REFINE_CAST__<T>(value: T): <R extends T>() => R;
 declare function __FIX_THIS_CASTING__<T>(value: unknown): T;
 type __FIX_THIS_TYPING__ = any;
 declare function __FIX_THIS_TYPING__(value: unknown): __LEGIT_ANY__;
+/**
+ * Any type that is not a primitive (number, string, boolean, null, undefined, symbol, bigint, ...)
+ * Equivalent to `object` type
+ */
+type AnyNonPrimitiveValue = object;
 
-export { __FIX_THIS_CASTING__, __FIX_THIS_TYPING__, __LEGIT_ANY_CAST__, type __LEGIT_ANY__, __LEGIT_CAST__, __REFINE_CAST__ };
+export { type AnyNonPrimitiveValue, type EmptyObject, __FIX_THIS_CASTING__, __FIX_THIS_TYPING__, __LEGIT_ANY_CAST__, type __LEGIT_ANY_FUNCTION__, type __LEGIT_ANY__, __LEGIT_CAST__, __REFINE_CAST__ };

package/lib/saferTyping.d.ts

@@ -1,5 +1,10 @@
 /** Use this only when you have 100% of certainty that this will not break the types */
 type __LEGIT_ANY__ = any;
+type __LEGIT_ANY_FUNCTION__ = (...params: any) => __LEGIT_ANY__;
+/**
+ * An empty object type, equivalent to `{}` but with safer typing
+ */
+type EmptyObject = Record<string, never>;
 /**
  * Cast a value to `any` type. Use this when you have legit usage of `any` casting.
  *
@@ -23,5 +28,10 @@ declare function __REFINE_CAST__<T>(value: T): <R extends T>() => R;
 declare function __FIX_THIS_CASTING__<T>(value: unknown): T;
 type __FIX_THIS_TYPING__ = any;
 declare function __FIX_THIS_TYPING__(value: unknown): __LEGIT_ANY__;
+/**
+ * Any type that is not a primitive (number, string, boolean, null, undefined, symbol, bigint, ...)
+ * Equivalent to `object` type
+ */
+type AnyNonPrimitiveValue = object;
 
-export { __FIX_THIS_CASTING__, __FIX_THIS_TYPING__, __LEGIT_ANY_CAST__, type __LEGIT_ANY__, __LEGIT_CAST__, __REFINE_CAST__ };
+export { type AnyNonPrimitiveValue, type EmptyObject, __FIX_THIS_CASTING__, __FIX_THIS_TYPING__, __LEGIT_ANY_CAST__, type __LEGIT_ANY_FUNCTION__, type __LEGIT_ANY__, __LEGIT_CAST__, __REFINE_CAST__ };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ls-stack/utils",
   "description": "Typescript utils",
-  "version": "3.12.2",
+  "version": "3.13.0",
   "license": "MIT",
   "files": [
     "lib"
@@ -74,6 +74,10 @@
       "import": "./lib/exhaustiveMatch.js",
       "require": "./lib/exhaustiveMatch.cjs"
     },
+    "./getCompositeKey": {
+      "import": "./lib/getCompositeKey.js",
+      "require": "./lib/getCompositeKey.cjs"
+    },
     "./getValueStableKey": {
       "import": "./lib/getValueStableKey.js",
       "require": "./lib/getValueStableKey.cjs"