@splendidlabz/utils 1.16.1 → 1.17.0

package/dist/cjs/lib/index.cjs

@@ -98,6 +98,7 @@ __export(lib_exports, {
   sanitizeObject: () => sanitizeObject,
   scatter: () => scatter,
   seededRandom: () => seededRandom,
+  settle: () => settle,
   shuffle: () => shuffle,
   singular: () => singular,
   sizeOf: () => sizeOf,
@@ -1097,6 +1098,35 @@ function reject(props, { includeStack = true } = {}) {
   return Promise.reject(omitEmpty(err));
 }
 
+// src/lib/promises/settle.js
+async function settle(promise) {
+  try {
+    return toSettled(await promise, null);
+  } catch (error) {
+    return toSettled(null, error);
+  }
+}
+function toSettled(result, error) {
+  const settled = Object.defineProperties(
+    { result, error },
+    {
+      r: { value: result },
+      e: { value: error },
+      [Symbol.iterator]: {
+        value: function* () {
+          yield result;
+          yield error;
+        }
+      }
+    }
+  );
+  return (
+    /** @type {Settled<T>} */
+    /** @type {unknown} */
+    settled
+  );
+}
+
 // src/lib/sse.js
 function createSSE({ event, data, id, retry }) {
   const eventString = event ? `event: ${event}
@@ -1791,6 +1821,7 @@ function getSymbolValue(object, description) {
   sanitizeObject,
   scatter,
   seededRandom,
+  settle,
   shuffle,
   singular,
   sizeOf,

package/dist/cjs/lib/promises/index.cjs

@@ -19,7 +19,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/lib/promises/index.js
 var promises_exports = {};
 __export(promises_exports, {
-  reject: () => reject
+  reject: () => reject,
+  settle: () => settle
 });
 module.exports = __toCommonJS(promises_exports);
 
@@ -139,7 +140,37 @@ function reject(props, { includeStack = true } = {}) {
   };
   return Promise.reject(omitEmpty(err));
 }
+
+// src/lib/promises/settle.js
+async function settle(promise) {
+  try {
+    return toSettled(await promise, null);
+  } catch (error) {
+    return toSettled(null, error);
+  }
+}
+function toSettled(result, error) {
+  const settled = Object.defineProperties(
+    { result, error },
+    {
+      r: { value: result },
+      e: { value: error },
+      [Symbol.iterator]: {
+        value: function* () {
+          yield result;
+          yield error;
+        }
+      }
+    }
+  );
+  return (
+    /** @type {Settled<T>} */
+    /** @type {unknown} */
+    settled
+  );
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  reject
+  reject,
+  settle
 });

package/dist/cjs/lib/promises/settle.cjs

@@ -0,0 +1,55 @@
+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/lib/promises/settle.js
+var settle_exports = {};
+__export(settle_exports, {
+  settle: () => settle
+});
+module.exports = __toCommonJS(settle_exports);
+async function settle(promise) {
+  try {
+    return toSettled(await promise, null);
+  } catch (error) {
+    return toSettled(null, error);
+  }
+}
+function toSettled(result, error) {
+  const settled = Object.defineProperties(
+    { result, error },
+    {
+      r: { value: result },
+      e: { value: error },
+      [Symbol.iterator]: {
+        value: function* () {
+          yield result;
+          yield error;
+        }
+      }
+    }
+  );
+  return (
+    /** @type {Settled<T>} */
+    /** @type {unknown} */
+    settled
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  settle
+});

package/dist/esm/lib/promises/index.js

@@ -1 +1,2 @@
 export * from "./reject.js";
+export * from "./settle.js";

package/dist/esm/lib/promises/settle.js

@@ -0,0 +1,30 @@
+async function settle(promise) {
+  try {
+    return toSettled(await promise, null);
+  } catch (error) {
+    return toSettled(null, error);
+  }
+}
+function toSettled(result, error) {
+  const settled = Object.defineProperties(
+    { result, error },
+    {
+      r: { value: result },
+      e: { value: error },
+      [Symbol.iterator]: {
+        value: function* () {
+          yield result;
+          yield error;
+        }
+      }
+    }
+  );
+  return (
+    /** @type {Settled<T>} */
+    /** @type {unknown} */
+    settled
+  );
+}
+export {
+  settle
+};

package/dist/types/lib/index.d.cts

@@ -38,6 +38,7 @@ export { sizeOf } from './objects/size.cjs';
 export { splitObject } from './objects/split.cjs';
 export { trimValues } from './objects/trim-values.cjs';
 export { reject } from './promises/reject.cjs';
+export { Settled, settle } from './promises/settle.cjs';
 export { createSSE, parseSSE } from './sse.cjs';
 export { toCamel, toKebab, toLower, toPascal, toSentence, toSlug, toTitle, toUpper } from './strings/convert-case/convert-case.cjs';
 export { markdown, treatMarkdownWhitespace } from './strings/markdown.cjs';

package/dist/types/lib/promises/index.d.cts

@@ -1 +1,2 @@
 export { reject } from './reject.cjs';
+export { Settled, settle } from './settle.cjs';

package/dist/types/lib/promises/settle.d.cts

@@ -0,0 +1,21 @@
+/**
+ * @template T
+ * @typedef {{ result: T | null, error: unknown, r: T | null, e: unknown } & [T | null, unknown]} Settled
+ */
+/**
+ * settle
+ * Awaits a promise and returns its error instead of throwing.
+ *
+ * @template T
+ * @param {Promise<T>} promise
+ * @returns {Promise<Settled<T>>}
+ */
+declare function settle<T>(promise: Promise<T>): Promise<Settled<T>>;
+type Settled<T> = {
+    result: T | null;
+    error: unknown;
+    r: T | null;
+    e: unknown;
+} & [T | null, unknown];
+
+export { type Settled, settle };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@splendidlabz/utils",
-  "version": "1.16.1",
+  "version": "1.17.0",
   "description": "",
   "license": "Elastic-2.0",
   "type": "module",