@dvirus-js/utils 0.0.4 → 0.0.7

package/CHANGELOG.md

@@ -1,3 +1,27 @@
+## 0.0.6 (2026-05-20)
+
+### 🩹 Fixes
+
+- update utils index exports ([7919620](https://github.com/Dvirus97/dvirus-js/commit/7919620))
+
+### ❤️ Thank You
+
+- Dvir Cohen
+
+## 0.0.5 (2026-05-20)
+
+This was a version bump only for utils to align it with other projects, there were no code changes.
+
+## 0.0.4 (2026-05-19)
+
+### 🩹 Fixes
+
+- minor formatting updates ([3dbc3e6](https://github.com/Dvirus97/dvirus-js/commit/3dbc3e6))
+
+### ❤️ Thank You
+
+- Dvir Cohen
+
 ## 0.0.3 (2026-05-19)
 
 ### 🩹 Fixes

package/index.js

@@ -1,62 +1,62 @@
-function G(t) {
-  return t.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").toLowerCase().replace(/[_-]+/g, " ").replace(/\s+/g, " ").trim();
+function I(e) {
+  return e.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").toLowerCase().replace(/[_-]+/g, " ").replace(/\s+/g, " ").trim();
 }
-function W(t, r) {
-  const e = G(t);
-  switch (r) {
+function re(e, n) {
+  const t = I(e);
+  switch (n) {
     case "lowercase":
-      return e.toLowerCase();
+      return t.toLowerCase();
     case "UPPERCASE":
-      return e.toUpperCase();
+      return t.toUpperCase();
     case "Title Case":
-      return e.split(" ").map(
-        (n) => n.charAt(0).toUpperCase() + n.slice(1).toLowerCase()
+      return t.split(" ").map(
+        (r) => r.charAt(0).toUpperCase() + r.slice(1).toLowerCase()
       ).join(" ");
     case "kebab-case":
-      return e.replace(/\s+/g, "-");
+      return t.replace(/\s+/g, "-");
     case "snake_case":
-      return e.replace(/\s+/g, "_");
+      return t.replace(/\s+/g, "_");
     case "camelCase": {
-      const n = e.split(" ");
-      return n.length === 0 ? "" : n[0]?.toLowerCase() + n.slice(1).map(
+      const r = t.split(" ");
+      return r.length === 0 ? "" : r[0]?.toLowerCase() + r.slice(1).map(
         (o) => o.charAt(0).toUpperCase() + o.slice(1).toLowerCase()
       ).join("");
     }
     case "PascalCase":
-      return e.split(" ").map(
-        (n) => n.charAt(0).toUpperCase() + n.slice(1).toLowerCase()
+      return t.split(" ").map(
+        (r) => r.charAt(0).toUpperCase() + r.slice(1).toLowerCase()
       ).join("");
     case "dot.case":
-      return e.replace(/\s+/g, ".");
+      return t.replace(/\s+/g, ".");
     case "path/case":
-      return e.replace(/\s+/g, "/");
+      return t.replace(/\s+/g, "/");
     case "Sentence case":
-      return e.replace(/(^\s*\w|[.!?]\s*\w)/g, (n) => n.toUpperCase()).replace(/\bi\b/g, "I");
+      return t.replace(/(^\s*\w|[.!?]\s*\w)/g, (r) => r.toUpperCase()).replace(/\bi\b/g, "I");
     case "Header-Case":
-      return e.split(" ").map(
-        (n) => n.charAt(0).toUpperCase() + n.slice(1).toLowerCase()
+      return t.split(" ").map(
+        (r) => r.charAt(0).toUpperCase() + r.slice(1).toLowerCase()
       ).join("-");
     case "reverse":
-      return e.split("").reverse().join("");
+      return t.split("").reverse().join("");
     default:
-      throw new Error(`Unsupported case type: ${r}`);
+      throw new Error(`Unsupported case type: ${n}`);
   }
 }
-async function Y(t) {
+async function se(e) {
   try {
-    return [await t, null];
-  } catch (r) {
-    return [null, r];
+    return [await (typeof e == "function" ? e() : e), null];
+  } catch (n) {
+    return [null, n];
   }
 }
-function E(t) {
+function E(e) {
   try {
-    return [t(), null];
-  } catch (r) {
-    return [null, r];
+    return [e(), null];
+  } catch (n) {
+    return [null, n];
   }
 }
-const ee = {
+const oe = {
   /**
    * Makes a GET request to the specified URL.
    *
@@ -65,9 +65,8 @@ const ee = {
    * @returns {Promise<any>} The response data.
    * @throws {Error} If the response is not ok.
    */
-  get: async function(t, r) {
-    const e = await fetch(t, r);
-    return await C(e);
+  get: async function(e, n) {
+    return await C(() => fetch(e, n), n);
   },
   /**
    * Makes a POST request to the specified URL with the given data.
@@ -79,17 +78,19 @@ const ee = {
    * @returns {Promise<R>} The response data.
    * @throws {Error} If the response is not ok.
    */
-  post: async function(t, r, e) {
-    const n = await fetch(t, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...e?.headers
-      },
-      body: JSON.stringify(r),
-      ...e
-    });
-    return await C(n);
+  post: async function(e, n, t) {
+    return await C(
+      () => fetch(e, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...t?.headers
+        },
+        body: JSON.stringify(n),
+        ...t
+      }),
+      t
+    );
   },
   /**
    * Makes a DELETE request to the specified URL with the given ID.
@@ -101,17 +102,19 @@ const ee = {
    * @returns {Promise<R>} The response data.
    * @throws {Error} If the response is not ok.
    */
-  delete: async function(t, r, e) {
-    const n = await fetch(t, {
-      method: "DELETE",
-      headers: {
-        "Content-Type": "application/json",
-        ...e?.headers
-      },
-      body: JSON.stringify({ id: r }),
-      ...e
-    });
-    return await C(n);
+  delete: async function(e, n, t) {
+    return await C(
+      () => fetch(e, {
+        method: "DELETE",
+        headers: {
+          "Content-Type": "application/json",
+          ...t?.headers
+        },
+        body: JSON.stringify({ id: n }),
+        ...t
+      }),
+      t
+    );
   },
   /**
    * Makes a PATCH request to the specified URL with the given data.
@@ -123,17 +126,19 @@ const ee = {
    * @returns {Promise<R>} The response data.
    * @throws {Error} If the response is not ok.
    */
-  patch: async function(t, r, e) {
-    const n = await fetch(t, {
-      method: "PATCH",
-      headers: {
-        "Content-Type": "application/json",
-        ...e?.headers
-      },
-      body: JSON.stringify(r),
-      ...e
-    });
-    return await C(n);
+  patch: async function(e, n, t) {
+    return await C(
+      () => fetch(e, {
+        method: "PATCH",
+        headers: {
+          "Content-Type": "application/json",
+          ...t?.headers
+        },
+        body: JSON.stringify(n),
+        ...t
+      }),
+      t
+    );
   },
   /**
    * Makes a PUT request to the specified URL with the given data.
@@ -145,62 +150,123 @@ const ee = {
    * @returns {Promise<R>} The response data.
    * @throws {Error} If the response is not ok.
    */
-  put: async function(t, r, e) {
-    const n = await fetch(t, {
-      method: "PUT",
-      headers: {
-        "Content-Type": "application/json",
-        ...e?.headers
-      },
-      body: JSON.stringify(r),
-      ...e
-    });
-    return await C(n);
+  put: async function(e, n, t) {
+    return await C(
+      () => fetch(e, {
+        method: "PUT",
+        headers: {
+          "Content-Type": "application/json",
+          ...t?.headers
+        },
+        body: JSON.stringify(n),
+        ...t
+      }),
+      t
+    );
   }
 };
-async function C(t) {
-  if (!t.ok) throw new Error(`Error: ${t.statusText}`);
-  return await t.json();
-}
-function te(t, r) {
-  const e = {};
-  return t?.forEach((n, o) => {
-    const s = r(n, o, t)?.toString();
-    s && (e[s] ??= [], e[s].push(n));
-  }), e;
-}
-async function re(t) {
-  return await new Promise((r) => setTimeout(r, t));
-}
-function ne(t, r, e) {
-  return r < t ? t : r > e ? e : r;
-}
-function se(t, r, e) {
-  let n;
-  return e?.isLoadingFn?.(!1), Object.assign((...s) => {
-    clearTimeout(n), e?.isLoadingFn?.(!0), n = setTimeout(() => {
-      e?.isLoadingFn?.(!1), t(...s);
-    }, r);
+async function C(e, n) {
+  try {
+    const t = await e();
+    if (!t.ok) {
+      const r = await t.text().catch(() => "");
+      throw Object.assign(
+        new Error(`HTTP ${t.status} ${t.statusText}`),
+        {
+          status: t.status,
+          statusText: t.statusText,
+          body: r
+        }
+      );
+    }
+    return n?.parse === "JSON" ? await t.json() : n?.parse === "TEXT" ? await t.text() : n?.parse === "BLOB" ? await t.blob() : n?.parse === "ARRAYBUFFER" ? await t.arrayBuffer() : await t.json();
+  } catch (t) {
+    throw H(t) ? t : Object.assign(
+      new Error(
+        t instanceof Error ? t.message : "Network request failed"
+      ),
+      {
+        status: G(t),
+        statusText: "NETWORK_ERROR",
+        code: V(t),
+        isNetworkError: !0,
+        cause: t
+      }
+    );
+  }
+}
+function G(e) {
+  if (typeof e == "object" && e !== null && "status" in e && typeof e.status == "number")
+    return e.status;
+}
+function V(e) {
+  if (typeof e == "object" && e !== null && "code" in e && typeof e.code == "string")
+    return e.code;
+  if (typeof e == "object" && e !== null && "cause" in e && typeof e.cause == "object" && e.cause !== null && "code" in e.cause && typeof e.cause.code == "string")
+    return e.cause.code;
+}
+function H(e) {
+  return typeof e == "object" && e !== null && "status" in e && typeof e.status == "number";
+}
+function ae(e, n) {
+  const t = {};
+  return e?.forEach((r, o) => {
+    const s = n(r, o, e)?.toString();
+    s && (t[s] ??= [], t[s].push(r));
+  }), t;
+}
+async function ie(e) {
+  return await new Promise((n) => setTimeout(n, e));
+}
+function ce(e, n, t) {
+  return n < e ? e : n > t ? t : n;
+}
+function le(e, n, t) {
+  let r;
+  return t?.isLoadingFn?.(!1), Object.assign((...s) => {
+    clearTimeout(r), t?.isLoadingFn?.(!0), r = setTimeout(() => {
+      t?.isLoadingFn?.(!1), e(...s);
+    }, n);
   }, {
     cancel() {
-      clearTimeout(n), e?.isLoadingFn?.(!1);
+      clearTimeout(r), t?.isLoadingFn?.(!1);
     }
   });
 }
-function oe(t, r) {
-  if (!r || typeof r != "string" || typeof t != "object" || t === null)
+function J(e, n) {
+  if (!n || typeof n != "string" || typeof e != "object" || e === null)
     return;
-  const e = r.split(".");
-  function n(o, s) {
+  const t = n.split(".");
+  function r(o, s) {
     if (!s || typeof s != "object")
       return;
     const a = o[0];
     if (a in s)
-      return o.length === 1 ? s[a] : n(o.slice(1), s[a]);
+      return o.length === 1 ? s[a] : r(o.slice(1), s[a]);
   }
-  return n(e, t);
+  return r(t, e);
 }
-class m {
+function Z(e, n, t) {
+  let r = e;
+  for (let o = 0; o < n.length; o++) {
+    const s = n[o] ?? "";
+    o === n.length - 1 ? r[s] = t : ((!r[s] || typeof r[s] != "object") && (r[s] = {}), r = r[s]);
+  }
+}
+function ue(e, n) {
+  const t = {};
+  if (!e || typeof e != "object")
+    return t;
+  for (const r of n) {
+    const o = J(e, r);
+    if (o !== void 0) {
+      const s = r.split(".");
+      Z(t, s, o);
+    }
+  }
+  return t;
+}
+class y {
   #e = null;
   #t = null;
   /**
@@ -208,24 +274,24 @@ class m {
    * @param {T} val - The success value.
    * @returns {Result<T, never>} A Result instance representing a success.
    */
-  static ok(r) {
-    return new m(r, null);
+  static ok(n) {
+    return new y(n, null);
   }
   /**
    * Creates a failed result.
    * @param {E | string} err - The error value or message.
    * @returns {Result<never, E>} A Result instance representing a failure.
    */
-  static err(r) {
-    return typeof r == "string" ? new m(null, new Error(r)) : new m(null, r);
+  static err(n) {
+    return typeof n == "string" ? new y(null, new Error(n)) : new y(null, n);
   }
   /**
    * Wraps a promise in a Result.
    * @param {Promise<T>} promise - The promise to wrap.
    * @returns {Promise<Result<T, E>>} A promise that resolves to a Result.
    */
-  static async promise(r) {
-    return r.then((e) => m.ok(e ?? "__void__")).catch((e) => m.err(e));
+  static async promise(n) {
+    return n.then((t) => y.ok(t)).catch((t) => y.err(t));
   }
   /**
    * Wraps a function call in a Result.
@@ -233,12 +299,12 @@ class m {
    * @param {...any[]} args - The arguments to pass to the function.
    * @returns {Result<T, E>} A Result instance representing the function call result.
    */
-  static func(r, ...e) {
+  static func(n, ...t) {
     try {
-      const n = r(...e);
-      return m.ok(n);
-    } catch (n) {
-      return m.err(n);
+      const r = n(...t);
+      return y.ok(r);
+    } catch (r) {
+      return y.err(r);
     }
   }
   /**
@@ -246,16 +312,16 @@ class m {
    * @param {E | null} err - The error value.
    * @throws {Error} If both ok and err are provided or neither is provided.
    */
-  constructor(r, e) {
-    if (!r && !e)
+  constructor(n, t) {
+    if (n == null && t == null)
       throw new Error(
         "Result must be initialized with either an ok or an err value"
       );
-    if (r && e)
+    if (n != null && t != null)
       throw new Error(
         "Result can't be initialized with both an ok and an err value"
       );
-    r != null ? this.#e = r : this.#t = e;
+    n != null ? this.#e = n : this.#t = t;
   }
   /**
    * Gets the success value, throwing an error if the result is a failure.
@@ -280,8 +346,8 @@ class m {
    * @param {T} defaultValue - The default value to return if the result is a failure.
    * @returns {T} The success value or the default value.
    */
-  unwrapOr(r) {
-    return this.isOk() ? this.#e : r;
+  unwrapOr(n) {
+    return this.isOk() ? this.#e : n;
   }
   /**
    * Gets the success value, throwing a custom error message if the result is a failure.
@@ -289,15 +355,15 @@ class m {
    * @returns {T} The success value.
    * @throws {Error} If the result is a failure.
    */
-  expect(r) {
+  expect(n) {
     if (this.isOk())
       return this.#e;
     if (this.isErr()) {
-      const e = this.#t;
-      throw new Error(r + `:
-` + e.message);
+      const t = this.#t;
+      throw new Error(n + `:
+` + t.message);
     }
-    throw new Error(r);
+    throw new Error(n);
   }
   /**
    * Checks if the result is a success.
@@ -321,168 +387,168 @@ class m {
     return this.#t;
   }
 }
-function ae(t, r = []) {
-  return t == null ? r : Array.isArray(t) ? t : [t];
+function fe(e, n = []) {
+  return e == null ? n : Array.isArray(e) ? e : [e];
 }
-const z = /* @__PURE__ */ Symbol("SIGNAL"), ie = (t) => typeof t == "function" && z in t, p = [], ce = (t) => {
-  const r = p.splice(0, p.length);
+const O = /* @__PURE__ */ Symbol("SIGNAL"), de = (e) => typeof e == "function" && O in e, p = [], pe = (e) => {
+  const n = p.splice(0, p.length);
   try {
-    return t();
+    return e();
   } finally {
-    p.push(...r);
+    p.push(...n);
   }
-}, A = (t, r) => {
-  const e = /* @__PURE__ */ new Set();
-  let n = 0;
+}, j = (e, n) => {
+  const t = /* @__PURE__ */ new Set();
+  let r = 0;
   const o = () => {
     const l = p[p.length - 1];
-    l && (e.add(l.setDirty), l.addSource(() => {
-      e.delete(l.setDirty);
+    l && (t.add(l.setDirty), l.addSource(() => {
+      t.delete(l.setDirty);
     }));
   }, s = (l) => {
-    for (const y of Array.from(e)) y(l);
-  }, a = () => n > 0;
-  return { read: Object.assign(() => (o(), t()), {
-    [z]: !0,
-    subscribe: (l) => (e.add(l), n++, r?.(), () => {
-      e.delete(l), n--;
+    for (const m of Array.from(t)) m(l);
+  }, a = () => r > 0;
+  return { read: Object.assign(() => (o(), e()), {
+    [O]: !0,
+    subscribe: (l) => (t.add(l), r++, n?.(), () => {
+      t.delete(l), r--;
     })
   }), notify: s, hasSubscribers: a };
-}, S = (t) => {
-  let r = t;
-  const { read: e, notify: n } = A(() => r);
-  return Object.assign(e, {
+}, S = (e) => {
+  let n = e;
+  const { read: t, notify: r } = j(() => n);
+  return Object.assign(t, {
     set: (o) => {
-      r !== o && (r = o, n(o));
+      n !== o && (n = o, r(o));
     },
     update: (o) => {
-      const s = o(r);
-      r !== s && (r = s, n(s));
+      const s = o(n);
+      n !== s && (n = s, r(s));
     },
-    asReadonly: () => e
+    asReadonly: () => t
   });
-}, k = (t) => {
-  const r = /* @__PURE__ */ new Set();
-  let e = !1, n = null, o = !1;
+}, k = (e) => {
+  const n = /* @__PURE__ */ new Set();
+  let t = !1, r = null, o = !1;
   const s = () => {
-    if (o = !1, e) return;
-    n && (n(), n = null), r.forEach((i) => i()), r.clear();
+    if (o = !1, t) return;
+    r && (r(), r = null), n.forEach((i) => i()), n.clear();
     const a = (i) => {
-      n = i;
+      r = i;
     };
     p.push({
       setDirty: () => {
-        !e && !o && (o = !0, queueMicrotask(s));
+        !t && !o && (o = !0, queueMicrotask(s));
       },
-      addSource: (i) => r.add(i)
-    }), t(a), p.pop();
+      addSource: (i) => n.add(i)
+    }), e(a), p.pop();
   };
   return s(), {
     destroy() {
-      e = !0, n && (n(), n = null), r.forEach((a) => a()), r.clear();
+      t = !0, r && (r(), r = null), n.forEach((a) => a()), n.clear();
     }
   };
-}, L = (t) => {
-  const r = /* @__PURE__ */ new Set();
-  let e, n = !0, o = () => {
+}, L = (e) => {
+  const n = /* @__PURE__ */ new Set();
+  let t, r = !0, o = () => {
   };
   const s = () => {
-    r.forEach((c) => c()), r.clear(), p.push({
+    n.forEach((c) => c()), n.clear(), p.push({
       setDirty: () => {
-        if (n) return;
-        n = !0;
-        const c = e;
-        s(), e !== c && o(e);
+        if (r) return;
+        r = !0;
+        const c = t;
+        s(), t !== c && o(t);
       },
-      addSource: (c) => r.add(c)
-    }), e = t(), n = !1, p.pop();
-  }, { read: a, notify: i } = A(
-    () => (n && s(), e),
+      addSource: (c) => n.add(c)
+    }), t = e(), r = !1, p.pop();
+  }, { read: a, notify: i } = j(
+    () => (r && s(), t),
     () => {
-      n && s();
+      r && s();
     }
   );
   return o = i, a;
 };
-function le(t) {
-  const r = typeof t == "function", e = r ? void 0 : t.source, n = r ? t : t.computation, o = /* @__PURE__ */ new Set();
+function he(e) {
+  const n = typeof e == "function", t = n ? void 0 : e.source, r = n ? e : e.computation, o = /* @__PURE__ */ new Set();
   let s, a = !0, i = !1, c, l = () => {
   };
-  const y = () => {
+  const m = () => {
     if (o.forEach((u) => u()), o.clear(), p.push({
       setDirty: () => {
         if (a) return;
         a = !0, i = !1;
         const u = s;
-        y(), s !== u && l(s);
+        m(), s !== u && l(s);
       },
       addSource: (u) => o.add(u)
-    }), r)
-      s = n();
+    }), n)
+      s = r();
     else {
-      const u = e?.();
-      s = n(u, c), c = { source: u, value: s };
+      const u = t?.();
+      s = r(u, c), c = { source: u, value: s };
     }
     a = !1, p.pop();
-  }, { read: v, notify: d } = A(
-    () => (a && !i && y(), s),
+  }, { read: T, notify: d } = j(
+    () => (a && !i && m(), s),
     () => {
-      a && !i && y();
+      a && !i && m();
     }
   );
   l = d;
-  const b = Object.assign(v, {
+  const b = Object.assign(T, {
     set: (u) => {
       s !== u && (s = u, i = !0, a = !1, d(u));
     },
     update: (u) => {
-      a && !i && y(), b.set(u(s));
+      a && !i && m(), b.set(u(s));
     },
-    asReadonly: () => v
+    asReadonly: () => T
   });
   return b;
 }
-class F extends Error {
-  constructor(r) {
-    const e = r instanceof Error ? `:
-${r.message}` : "";
-    super(`Cannot read resource value while in error state${e}`, { cause: r }), this.name = "ResourceErrorState";
+class q extends Error {
+  constructor(n) {
+    const t = n instanceof Error ? `:
+${n.message}` : "";
+    super(`Cannot read resource value while in error state${t}`, { cause: n }), this.name = "ResourceErrorState";
   }
 }
-function ue(t) {
-  const r = S(void 0), e = S("idle"), n = S(void 0), o = L(() => e() === "loading"), s = S(0), a = L(() => {
-    if (e() === "error")
-      throw new F(n());
-    return r();
+function ge(e) {
+  const n = S(void 0), t = S("idle"), r = S(void 0), o = L(() => t() === "loading"), s = S(0), a = L(() => {
+    if (t() === "error")
+      throw new q(r());
+    return n();
   }), i = (d) => {
-    r.set(d), n.set(void 0), e.set("resolved");
+    n.set(d), r.set(void 0), t.set("resolved");
   }, c = (d) => {
-    r.update(d), n.set(void 0), e.set("resolved");
-  }, l = "params" in t;
-  if ("stream" in t) {
+    n.update(d), r.set(void 0), t.set("resolved");
+  }, l = "params" in e;
+  if ("stream" in e) {
     const d = S(void 0), b = k((g) => {
       s();
       const f = new AbortController();
       g(() => f.abort());
-      const D = l ? t.params() : void 0;
-      e.set("loading"), n.set(void 0);
-      const $ = t.stream, I = $(l ? {
-        params: D,
+      const _ = l ? e.params() : void 0;
+      t.set("loading"), r.set(void 0);
+      const $ = e.stream, F = $(l ? {
+        params: _,
         abortSignal: f.signal
       } : {
         abortSignal: f.signal
       });
-      d.set(I);
+      d.set(F);
     }), u = k(() => {
       const g = d();
       if (!g) return;
       const f = g();
-      f && ("error" in f && f.error !== void 0 ? (n.set(f.error), e.set("error")) : "value" in f && (r.set(f.value), e.set("resolved")));
+      f && ("error" in f && f.error !== void 0 ? (r.set(f.error), t.set("error")) : "value" in f && (n.set(f.value), t.set("resolved")));
     });
     return {
       value: a,
-      status: e,
-      error: n,
+      status: t,
+      error: r,
       isLoading: o,
       set: i,
       update: c,
@@ -494,36 +560,36 @@ function ue(t) {
       }
     };
   }
-  const v = k((d) => {
+  const T = k((d) => {
     s();
-    const b = l ? t.params() : void 0;
-    e.set("loading"), n.set(void 0);
+    const b = l ? e.params() : void 0;
+    t.set("loading"), r.set(void 0);
     const u = new AbortController();
     d(() => u.abort());
     const g = l ? { params: b, abortSignal: u.signal } : { abortSignal: u.signal };
-    t.loader(g).then(
+    e.loader(g).then(
       (f) => {
-        u.signal.aborted || (r.set(f), e.set("resolved"));
+        u.signal.aborted || (n.set(f), t.set("resolved"));
       },
       (f) => {
-        u.signal.aborted || (n.set(f), e.set("error"));
+        u.signal.aborted || (r.set(f), t.set("error"));
       }
     );
   });
   return {
     value: a,
-    status: e,
-    error: n,
+    status: t,
+    error: r,
     isLoading: o,
     set: i,
     update: c,
     reload: () => {
       s.update((d) => d + 1);
     },
-    destroy: () => v.destroy()
+    destroy: () => T.destroy()
   };
 }
-const x = /* @__PURE__ */ new Map([
+const A = /* @__PURE__ */ new Map([
   ["b", "b"],
   ["i", "i"],
   ["u", "u"],
@@ -547,7 +613,7 @@ const x = /* @__PURE__ */ new Map([
   ["ul", "ul"],
   ["ol", "ol"],
   ["li", "li"]
-]), T = /* @__PURE__ */ new Set([
+]), v = /* @__PURE__ */ new Set([
   "div",
   "p",
   "ul",
@@ -560,14 +626,14 @@ const x = /* @__PURE__ */ new Map([
   "h5",
   "h6"
 ]);
-let O = "rtp-";
-function N() {
-  return O;
+let R = "rtp-";
+function M() {
+  return R;
 }
-function V(t) {
-  O = t;
+function X(e) {
+  R = e;
 }
-const j = /* @__PURE__ */ new Map([
+const N = /* @__PURE__ */ new Map([
   ["br", "br"],
   ["hr", "hr"]
 ]), w = /* @__PURE__ */ new Map([
@@ -658,12 +724,12 @@ const j = /* @__PURE__ */ new Map([
       ["margin", "1em 0"]
     ])
   ]
-]), M = (t, r, e, n, o) => {
-  const s = t.filter((i) => !T.has(i)), a = t.filter((i) => T.has(i));
+]), x = (e, n, t, r, o) => {
+  const s = e.filter((i) => !v.has(i)), a = e.filter((i) => v.has(i));
   return {
-    tagNames: t.join(","),
-    tagNamesList: t,
-    text: o ?? r.slice(e, n),
+    tagNames: e.join(","),
+    tagNamesList: e,
+    text: o ?? n.slice(t, r),
     style: s.map(
       (i) => [...w.get(i)?.entries() ?? []].map(([c, l]) => `${c}: ${l}`).join("; ")
     ).filter(Boolean).join("; "),
@@ -671,214 +737,216 @@ const j = /* @__PURE__ */ new Map([
       s.flatMap((i) => Array.from(w.get(i) ?? []))
     ),
     containerTagNames: a,
-    cssClass: s.map((i) => `${N()}${i}`).join(" ")
+    cssClass: s.map((i) => `${M()}${i}`).join(" ")
   };
-}, J = () => [...x.keys()].join("|"), H = () => [...j.keys()].join("|"), Z = () => new RegExp(
-  `<\\/?(${J()})>|<(${H()})\\s*/?>`,
+}, K = () => [...A.keys()].join("|"), W = () => [...N.keys()].join("|"), Y = () => new RegExp(
+  `<\\/?(${K()})>|<(${W()})\\s*/?>`,
   "gi"
 );
-function P(t, r) {
-  const e = w.get(t) ?? /* @__PURE__ */ new Map();
-  Object.entries(r).forEach(([n, o]) => e.set(n, o)), w.set(t, e);
-}
-function R() {
-  const t = [];
-  for (const [r, e] of w) {
-    if (e.size === 0) continue;
-    const n = [...e.entries()].map(([o, s]) => `  ${o}: ${s};`).join(`
+function z(e, n) {
+  const t = w.get(e) ?? /* @__PURE__ */ new Map();
+  Object.entries(n).forEach(([r, o]) => t.set(r, o)), w.set(e, t);
+}
+function P() {
+  const e = [];
+  for (const [n, t] of w) {
+    if (t.size === 0) continue;
+    const r = [...t.entries()].map(([o, s]) => `  ${o}: ${s};`).join(`
 `);
-    t.push(`.${N()}${r} {
-${n}
+    e.push(`.${M()}${n} {
+${r}
 }`);
   }
-  return t.join(`
+  return e.join(`
 `);
 }
-function q() {
+function Q() {
   if ("document" in globalThis) {
-    const t = R(), r = globalThis, e = r.document.getElementById(
+    const e = P(), n = globalThis, t = n.document.getElementById(
       "html-text-parser-styles"
     );
-    if (e) {
-      e.textContent = t;
+    if (t) {
+      t.textContent = e;
       return;
     }
-    const n = r.document.createElement("style");
-    n.textContent = t, n.setAttribute("id", "html-text-parser-styles"), r.document.head.appendChild(n);
+    const r = n.document.createElement("style");
+    r.textContent = e, r.setAttribute("id", "html-text-parser-styles"), n.document.head.appendChild(r);
     return;
   }
   console.warn(
     "[html-text-parser] Cannot inject stylesheet: document is not available."
   );
 }
-function X(t) {
-  const r = [];
-  let e;
-  for (const n of t) {
-    const o = n.containerTagNames.join(","), s = e?.containerTagNames.join(",");
-    o !== s && (e = {
-      containerTagNames: n.containerTagNames,
-      cssClass: n.containerTagNames.map((a) => `${N()}${a}`).join(" "),
-      style: n.containerTagNames.map(
+function ee(e) {
+  const n = [];
+  let t;
+  for (const r of e) {
+    const o = r.containerTagNames.join(","), s = t?.containerTagNames.join(",");
+    o !== s && (t = {
+      containerTagNames: r.containerTagNames,
+      cssClass: r.containerTagNames.map((a) => `${M()}${a}`).join(" "),
+      style: r.containerTagNames.map(
         (a) => [...w.get(a)?.entries() ?? []].map(([i, c]) => `${i}: ${c}`).join("; ")
       ).filter(Boolean).join("; "),
       styleObject: Object.fromEntries(
-        n.containerTagNames.flatMap(
+        r.containerTagNames.flatMap(
           (a) => Array.from(w.get(a) ?? [])
         )
       ),
       segments: []
-    }, r.push(e)), e.segments.push(n);
+    }, n.push(t)), t.segments.push(r);
   }
-  return r;
+  return n;
 }
-function K(t, r, e) {
+function te(e, n, t) {
   if (!("document" in globalThis)) {
     console.warn(
       "[html-text-parser] Cannot append segments: document is not available."
     );
     return;
   }
-  if (!t || !("appendChild" in t)) {
+  if (!e || !("appendChild" in e)) {
     console.warn(
       "[html-text-parser] Cannot append segments: provided element does not support appendChild."
     );
     return;
   }
-  e = { useClasses: !0, useStyles: !1, ...e };
-  const n = t, o = globalThis.document;
-  for (const s of r) {
+  t = { useClasses: !0, useStyles: !1, ...t };
+  const r = e, o = globalThis.document;
+  for (const s of n) {
     const a = o.createElement(
       s.containerTagNames[0] || "span"
     );
-    e.useClasses && (a.className = s.cssClass), e.useStyles && a.setAttribute("style", s.style);
+    t.useClasses && (a.className = s.cssClass), t.useStyles && a.setAttribute("style", s.style);
     for (const i of s.segments) {
       const c = o.createElement("span");
-      c.textContent = i.text, e.useClasses && (c.className = i.cssClass), e.useStyles && c.setAttribute("style", i.style), a.appendChild(c);
+      c.textContent = i.text, t.useClasses && (c.className = i.cssClass), t.useStyles && c.setAttribute("style", i.style), a.appendChild(c);
     }
-    n.appendChild(a);
+    r.appendChild(a);
   }
 }
-function h(t) {
-  return X(_(t));
+function h(e) {
+  return ee(B(e));
 }
-function _(t) {
-  const r = [], e = /* @__PURE__ */ new Map();
-  let n = 0;
-  for (const o of t.matchAll(Z())) {
+function B(e) {
+  const n = [], t = /* @__PURE__ */ new Map();
+  let r = 0;
+  for (const o of e.matchAll(Y())) {
     const s = o.index;
-    s > n && r.push(
-      M([...e.keys()], t, n, s)
+    s > r && n.push(
+      x([...t.keys()], e, r, s)
     );
     const a = o[2]?.toLowerCase();
-    if (a && j.has(a)) {
-      r.push(
-        M(
-          [...e.keys(), a],
-          t,
-          n,
+    if (a && N.has(a)) {
+      n.push(
+        x(
+          [...t.keys(), a],
+          e,
+          r,
           s,
           ""
         )
-      ), n = s + o[0].length;
+      ), r = s + o[0].length;
       continue;
     }
-    const i = o[0][1] === "/", c = x.get(o[1]?.toLowerCase() ?? "") ?? "";
+    const i = o[0][1] === "/", c = A.get(o[1]?.toLowerCase() ?? "") ?? "";
     if (i) {
-      const l = (e.get(c) ?? 1) - 1;
-      l <= 0 ? e.delete(c) : e.set(c, l);
+      const l = (t.get(c) ?? 1) - 1;
+      l <= 0 ? t.delete(c) : t.set(c, l);
     } else
-      e.set(c, (e.get(c) ?? 0) + 1);
-    n = s + o[0].length;
-  }
-  return n < t.length && r.push(
-    M(
-      [...e.keys()],
-      t,
-      n,
-      t.length
+      t.set(c, (t.get(c) ?? 0) + 1);
+    r = s + o[0].length;
+  }
+  return r < e.length && n.push(
+    x(
+      [...t.keys()],
+      e,
+      r,
+      e.length
     )
-  ), r;
+  ), n;
 }
-function B(t) {
-  if (Array.isArray(t)) {
-    t.forEach((e) => {
-      B(e);
+function U(e) {
+  if (Array.isArray(e)) {
+    e.forEach((t) => {
+      U(t);
     });
     return;
   }
-  const r = t.tagName ?? t.tag;
-  x.set(t.tag, r), t.style != null && Object.keys(t.style).length && P(r, t.style);
+  const n = e.tagName ?? e.tag;
+  A.set(e.tag, n), e.style != null && Object.keys(e.style).length && z(n, e.style);
 }
-function U(t) {
-  if (Array.isArray(t)) {
-    t.forEach((e) => {
-      U(e);
+function D(e) {
+  if (Array.isArray(e)) {
+    e.forEach((t) => {
+      D(t);
     });
     return;
   }
-  const r = t.tagName ?? t.tag;
-  j.set(t.tag, r), t.style != null && Object.keys(t.style).length && P(r, t.style);
-}
-h.setTag = B;
-h.setSelfClosingTag = U;
-h.setBlockTag = (t) => T.add(t);
-h.removeBlockTag = (t) => T.delete(t);
-h.setCssClassPrefix = V;
-h.getStylesheet = R;
-h.flat = _;
-h.generateStylesheet = q;
-h.appendToDom = K;
-function Q(t, r, e) {
-  function n(o) {
-    const [s, a] = E(() => e ? e(o) : o);
-    if (a) throw new Error(`Error transforming value for ${t}: ${a.message}`);
-    if (!r(s)) throw new Error(`"${o}" is not a valid ${t}`);
+  const n = e.tagName ?? e.tag;
+  N.set(e.tag, n), e.style != null && Object.keys(e.style).length && z(n, e.style);
+}
+h.setTag = U;
+h.setSelfClosingTag = D;
+h.setBlockTag = (e) => v.add(e);
+h.removeBlockTag = (e) => v.delete(e);
+h.setCssClassPrefix = X;
+h.getStylesheet = P;
+h.flat = B;
+h.generateStylesheet = Q;
+h.appendToDom = te;
+function ne(e, n, t) {
+  function r(o) {
+    const [s, a] = E(() => t ? t(o) : o);
+    if (a) throw new Error(`Error transforming value for ${e}: ${a.message}`);
+    if (!n(s)) throw new Error(`"${o}" is not a valid ${e}`);
     return s;
   }
-  return n.from = (o) => {
-    const [s, a] = E(() => e ? e(o) : o);
+  return r.from = (o) => {
+    const [s, a] = E(() => t ? t(o) : o);
     if (!a)
-      return r(s) ? s : void 0;
-  }, n.is = (o) => {
-    const s = E(() => e ? e(o) : o)[0] ?? o;
-    return r(s);
-  }, n;
+      return n(s) ? s : void 0;
+  }, r.is = (o) => {
+    const s = E(() => t ? t(o) : o)[0] ?? o;
+    return n(s);
+  }, r;
 }
-const fe = Q(
+const ye = ne(
   "NumericString",
-  (t) => (
+  (e) => (
     // checks that a given value is:
     // - a number, and the number is neither positive Infinity, negative Infinity, nor NaN.
-    typeof t == "string" && t.trim() !== "" && Number.isFinite(Number(t))
+    typeof e == "string" && e.trim() !== "" && Number.isFinite(Number(e))
   ),
-  (t) => String(t)
+  (e) => String(e)
 );
 export {
-  fe as NumericString,
-  m as Result,
-  z as SIGNAL,
-  ne as clamp,
+  ye as NumericString,
+  y as Result,
+  O as SIGNAL,
+  ce as clamp,
   L as computed,
-  W as convertCase,
-  Q as createBrand,
-  se as debounce,
-  re as delay,
+  re as convertCase,
+  ne as createBrand,
+  le as debounce,
+  ie as delay,
   k as effect,
-  oe as getProp,
-  te as groupBy,
-  ee as http,
-  ie as isSignal,
-  le as linkedSignal,
-  G as normalizeString,
+  J as getProp,
+  ae as groupBy,
+  oe as http,
+  de as isSignal,
+  he as linkedSignal,
+  I as normalizeString,
   h as parseRichText,
-  _ as parseRichTextFlat,
-  ue as resource,
-  B as setRichTextTag,
-  U as setSelfClosingTag,
+  B as parseRichTextFlat,
+  ue as pickPaths,
+  ge as resource,
+  Z as setDeepValue,
+  U as setRichTextTag,
+  D as setSelfClosingTag,
   S as signal,
-  ae as toArray,
+  fe as toArray,
   E as tryCatch,
-  Y as tryCatchAsync,
-  ce as untracked
+  se as tryCatchAsync,
+  pe as untracked
 };

package/lib/getProp.d.ts

@@ -15,3 +15,13 @@ export type PathValue<T, P extends string> = P extends `${infer K}.${infer Rest}
  * @returns {PathValue<T, P>} The value at the given path, or undefined if the path is invalid.
  */
 export declare function getProp<T, P extends string>(obj: T, path: P): PathValue<T, P>;
+/**
+ * Utility to deeply set a value in an object at a given path array.
+ * This is a helper function to reconstruct the object structure.
+ */
+export declare function setDeepValue<TObj extends object, TValue = any>(obj: TObj, keysPath: string[], value: TValue): void;
+/**
+ * Takes an object and an array of paths, returning a new object
+ * that preserves the original nested structure for the requested keys.
+ */
+export declare function pickPaths<T, P extends string>(obj: T, paths: readonly P[]): Partial<T>;

package/lib/http.d.ts

@@ -1,3 +1,14 @@
+export type HttpError = Error & {
+    status?: number;
+    statusText?: string;
+    body?: string;
+    code?: string;
+    isNetworkError?: boolean;
+    cause?: unknown;
+};
+export interface RequestInit extends globalThis.RequestInit {
+    parse?: 'JSON' | 'TEXT' | 'BLOB' | 'ARRAYBUFFER';
+}
 /**
  * A utility object for making HTTP requests.
  */

package/lib/tryCatch.d.ts

@@ -11,7 +11,7 @@ export type TryResult<T, E = Error> = [T, null] | [null, E];
  * @param {Promise<T>} promise - The promise to handle
  * @returns {Promise<TryResult<T, E>>} - A promise that resolves to a tuple with either the result or the error
  */
-export declare function tryCatchAsync<T, E = Error>(promise: Promise<T>): Promise<TryResult<T, E>>;
+export declare function tryCatchAsync<T, E = Error>(promise: Promise<T> | (() => Promise<T>)): Promise<TryResult<T, E>>;
 /**
  * Main wrapper function to handle promise with try-catch
  * @template T - Type of the successful result

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dvirus-js/utils",
-  "version": "0.0.4",
+  "version": "0.0.7",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",