@qwreey-js/ts-util 1.0.3 → 1.0.4

package/dist/utils.js

@@ -1,2 +1,142 @@
-export {};
+import { logErr } from "./libLog.js";
+import { Result } from "./result.js";
+/**
+ * Pads a given number with leading zeros to meet the specified length.
+ * @param {number} num The number to be padded.
+ * @param {number} [zeroLength=2] The desired total length of the resulting string. Defaults to 2.
+ * @returns {string} The padded string representation of the number.
+ */
+export function zeroPadding(num, length = 2) {
+    const numStr = Math.abs(num).toString();
+    const sign = Math.sign(num);
+    let signStr;
+    if (sign == -1) {
+        signStr = "-";
+    }
+    else {
+        signStr = "";
+    }
+    const numLength = Math.max(length - signStr.length, 0);
+    return signStr + numStr.padStart(numLength, "0");
+}
+/**
+ * Safely parses a JSON string. Returns null if a parsing error occurs.
+ * @template T The expected type of the parsed data.
+ * @param {string | undefined | null} content The JSON string to parse.
+ * @returns {T | null} The parsed object, or null if parsing fails.
+ */
+export function parseJsonSafe(content) {
+    if (!content)
+        return null;
+    try {
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Executes a promise and returns a boolean indicating success.
+ * Logs an error and returns false if the promise is rejected.
+ * @param {Promise<any>} promise The promise to execute.
+ * @returns {Promise<boolean>} True if the promise resolves successfully, false otherwise.
+ */
+export async function AsOk(promise) {
+    return await promise
+        .then(() => true)
+        .catch((i) => {
+        logErr("Promise throw(catch in AsOk): " + i);
+        return false;
+    });
+}
+/**
+ * Executes a promise and returns a wrapped result.
+ * @param {Promise<T>} promise The promise to execute.
+ * @returns {Promise<Result<T, Error>>} Result.ok(T) if the promise resolves successfully, Result.err(Error) otherwise.
+ */
+export async function AsResult(promise) {
+    return await promise.then(Result.ok).catch(Result.err);
+}
+/**
+ * Executes a promise and returns its result, or null if an error occurs.
+ * Logs the error if the promise is rejected.
+ * @template T The expected return type of the promise.
+ * @param {Promise<T>} promise The promise to execute.
+ * @returns {Promise<T | null>} The result of the promise, or null if it fails.
+ */
+export async function NullCatch(promise) {
+    return await promise.catch((i) => {
+        logErr("Promise throw(catch in NullCatch): " + i);
+        return null;
+    });
+}
+/**
+ * Returns an empty promise that resolves to undefined.
+ * @returns {Promise<undefined>}
+ */
+export async function EmptyPromise() { }
+/**
+ * Returns an promise that resolves to input value.
+ * @param {T} input The input value
+ * @returns {Promise<T>}
+ */
+export async function ValuePromise(input) {
+    return input;
+}
+/**
+ * Returns a promise that immediately rejects with the provided error.
+ * @param {Error} err The error to be thrown.
+ * @returns {Promise<any>}
+ */
+export async function ErrorPromise(err) {
+    throw err;
+}
+/**
+ * Merges multiple class names and arrays of class names into a single space-separated string.
+ * Falsy values such as null, undefined, or false are automatically filtered out.
+ * This function handles single-level arrays but does not support deep nesting.
+ *
+ * @param {...(ClassNameType | ClassNameType[])} classNameList - A list of class names or arrays containing class names.
+ * @returns {string} A combined string of valid class names separated by a space.
+ */
+export function mergeClassName(...classNameList) {
+    const buffer = [];
+    for (const className of classNameList) {
+        if (Array.isArray(className)) {
+            for (const item of className) {
+                if (item)
+                    buffer.push(item);
+            }
+        }
+        else if (className && className.length) {
+            buffer.push(className);
+        }
+    }
+    return buffer.join(" ");
+}
+export const TIB_UNIT = 1024 ** 4;
+export const GIB_UNIT = 1024 ** 3;
+export const MIB_UNIT = 1024 ** 2;
+export const KIB_UNIT = 1024 ** 1;
+/**
+ * Formats a file size in bytes into a human-readable string using binary prefixes (IEC standard).
+ *
+ * @param {number} sizeBytes - The size of the file in bytes.
+ * @returns {string} The formatted file size string with its corresponding unit (e.g., "1.5GiB", "500B").
+ */
+export function formatFileSize(sizeBytes) {
+    if (sizeBytes >= TIB_UNIT) {
+        return `${(sizeBytes / TIB_UNIT).toFixed(1)}TiB`;
+    }
+    else if (sizeBytes >= GIB_UNIT) {
+        return `${(sizeBytes / GIB_UNIT).toFixed(1)}GiB`;
+    }
+    else if (sizeBytes >= MIB_UNIT) {
+        return `${(sizeBytes / MIB_UNIT).toFixed(1)}MiB`;
+    }
+    else if (sizeBytes >= KIB_UNIT) {
+        return `${(sizeBytes / KIB_UNIT).toFixed(1)}KiB`;
+    }
+    return `${sizeBytes}B`;
+}
 //# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":""}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qwreey-js/ts-util",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Qwreey's typescript utilities",
   "keywords": [
     "typescript"