feat: add tryCatch utility function and update tests

Author: piotrkulpinski

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@primoui/utils",
   "description": "A lightweight set of utilities",
-  "version": "1.1.9",
+  "version": "1.1.10",
   "license": "MIT",
   "type": "module",
   "author": {

src/helpers/helpers.test.ts

@@ -12,6 +12,7 @@ import {
   slugify,
   splitArrayChunks,
   stripHtml,
+  tryCatch,
 } from "./helpers"
 
 describe("range", () => {
@@ -173,3 +174,22 @@ describe("joinAsSentence", () => {
     expect(joinAsSentence(["apple", "banana", "cherry"], 2)).toEqual("apple and banana")
   })
 })
+
+describe("tryCatch", () => {
+  it("should return data when promise resolves", async () => {
+    const promise = Promise.resolve("success")
+    const result = await tryCatch(promise)
+
+    expect(result.data).toEqual("success")
+    expect(result.error).toBeNull()
+  })
+
+  it("should return error when promise rejects", async () => {
+    const error = new Error("failure")
+    const promise = Promise.reject(error)
+    const result = await tryCatch(promise)
+
+    expect(result.data).toBeNull()
+    expect(result.error).toEqual(error)
+  })
+})

src/helpers/helpers.ts

@@ -197,3 +197,38 @@ export const joinAsSentence = (items: string[], maxItems = 3, lastItem = "and")
     .join(", ")
     .replace(/, ([^,]*)$/, ` ${lastItem} $1`)
 }
+
+/**
+ * A type representing a successful result with data and no error.
+ */
+type Success<T> = {
+  data: T
+  error: null
+}
+
+/**
+ * A type representing a failed result with no data and an error.
+ */
+type Failure<E> = {
+  data: null
+  error: E
+}
+
+/**
+ * A type representing a result with either data or an error.
+ */
+type Result<T, E = Error> = Success<T> | Failure<E>
+
+/**
+ * Wraps a promise and returns a result object with the data or error
+ * @param promise - The promise to wrap
+ * @returns A result object with the data or error
+ */
+export const tryCatch = async <T, E = Error>(promise: Promise<T>): Promise<Result<T, E>> => {
+  try {
+    const data = await promise
+    return { data, error: null }
+  } catch (error) {
+    return { data: null, error: error as E }
+  }
+}