@salespark/toolkit 2.1.12 → 2.1.14

package/README.md

@@ -584,14 +584,17 @@ isNilOrNaN("abc");
 // Result: true (coerced to NaN)
 ```
 
-**`formatBytes(bytes: number, si?: boolean, dp?: number): string`** — Formats bytes as human-readable text.
+**`formatBytes(bytes: number, si?: boolean, dp?: number, noSpace?: boolean): string`** — Formats bytes as human-readable text.
 
 ```javascript
+formatBytes(999, true);
+// Result: "999 Bytes"
+
 formatBytes(1024);
 // Result: "1.0 KiB"
 
-formatBytes(1000, true);
-// Result: "1.0 kB"
+formatBytes(1000, true, 1, true);
+// Result: "1.0kB"
 ```
 
 **`stringSimilarity(s1: string, s2: string): number`** — Returns the similarity between two strings (0..1).

package/dist/index.cjs

@@ -553,11 +553,11 @@ var isNullOrUndefinedInArray = hasNilOrEmpty;
 var isNullOrUndefinedEmptyOrZero = isNilEmptyOrZeroLen;
 var isNullUndefinedOrZero = isNilOrZeroLen;
 var isNullOrUndefinedOrNaN = isNilOrNaN;
-var formatBytes = (bytes, si = false, dp = 1) => {
+var formatBytes = (bytes, si = false, dp = 1, noSpace = false) => {
   if (!Number.isFinite(bytes)) return "NaN";
   const thresh = si ? 1e3 : 1024;
   const abs = Math.abs(bytes);
-  if (abs < thresh) return `${bytes} B`;
+  if (abs < thresh) return `${bytes} Bytes`;
   const units = si ? ["kB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"] : ["KiB", "MiB", "GiB", "TiB", "PiB", "EiB", "ZiB", "YiB"];
   let u = -1;
   const r = 10 ** dp;
@@ -566,7 +566,7 @@ var formatBytes = (bytes, si = false, dp = 1) => {
     value /= thresh;
     ++u;
   } while (Math.round(Math.abs(value) * r) / r >= thresh && u < units.length - 1);
-  return `${value.toFixed(dp)} ${units[u]}`;
+  return `${value.toFixed(dp)}${noSpace ? "" : " "}${units[u]}`;
 };
 var humanFileSize = formatBytes;
 var levenshtein = (a, b) => {
@@ -1745,6 +1745,90 @@ var assessSecurityRisks = (risks) => {
   return { score, level, recommendations };
 };
 
+// src/utils/defer.ts
+var swallow = (p) => p.catch(() => {
+});
+var deferPostReturn = (fn) => {
+  if (typeof fn !== "function") return;
+  const run = () => {
+    try {
+      const result = fn();
+      swallow(Promise.resolve(result));
+    } catch {
+    }
+  };
+  if (typeof queueMicrotask === "function") {
+    queueMicrotask(run);
+  } else {
+    Promise.resolve().then(run);
+  }
+};
+var deferNonCritical = (fn) => {
+  if (typeof fn !== "function") return;
+  const run = () => {
+    try {
+      const result = fn();
+      swallow(Promise.resolve(result));
+    } catch {
+    }
+  };
+  if (typeof setImmediate === "function") {
+    setImmediate(run);
+  } else {
+    setTimeout(run, 0);
+  }
+};
+var deferAfterResponse = (res, fn) => {
+  if (typeof fn !== "function") return;
+  if (res?.writableEnded === true) {
+    deferPostReturn(fn);
+    return;
+  }
+  if (!res || typeof res.once !== "function") {
+    deferPostReturn(fn);
+    return;
+  }
+  let executed = false;
+  const executeOnce = () => {
+    if (executed) return;
+    executed = true;
+    deferPostReturn(fn);
+  };
+  try {
+    res.once("finish", executeOnce);
+    res.once("close", executeOnce);
+  } catch {
+    if (!executed) {
+      deferPostReturn(fn);
+    }
+  }
+};
+var deferAfterResponseNonCritical = (res, fn) => {
+  if (typeof fn !== "function") return;
+  if (res?.writableEnded === true) {
+    deferNonCritical(fn);
+    return;
+  }
+  if (!res || typeof res.once !== "function") {
+    deferNonCritical(fn);
+    return;
+  }
+  let executed = false;
+  const executeOnce = () => {
+    if (executed) return;
+    executed = true;
+    deferNonCritical(fn);
+  };
+  try {
+    res.once("finish", executeOnce);
+    res.once("close", executeOnce);
+  } catch {
+    if (!executed) {
+      deferNonCritical(fn);
+    }
+  }
+};
+
 // src/index.ts
 var isBrowser = typeof globalThis !== "undefined" && typeof globalThis.document !== "undefined";
 var isNode = typeof process !== "undefined" && !!process.versions?.node;
@@ -1765,6 +1849,10 @@ exports.compact = compact;
 exports.currencyToSymbol = currencyToSymbol;
 exports.debounce = debounce;
 exports.deburr = deburr;
+exports.deferAfterResponse = deferAfterResponse;
+exports.deferAfterResponseNonCritical = deferAfterResponseNonCritical;
+exports.deferNonCritical = deferNonCritical;
+exports.deferPostReturn = deferPostReturn;
 exports.delay = delay;
 exports.difference = difference;
 exports.fill = fill;