@mll-lab/js-utils 2.4.0 → 2.7.0

package/dist/error.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Extract a message from a caught error.
+ *
+ * Since you can throw anything in JavaScript,
+ * the given error could be of any type.
+ */
+export declare function errorMessage(error: unknown): string;

package/dist/index.common.js

@@ -15111,6 +15111,44 @@ function formatDotlessDate(date) {
     return format(date, DOTLESS_DATE_FORMAT, { locale: de$1 });
 }
 
+/**
+ * Extract a message from a caught error.
+ *
+ * Since you can throw anything in JavaScript,
+ * the given error could be of any type.
+ */
+function errorMessage(error) {
+    const message = hasMessage(error) ? error.message : error;
+    if (message === undefined) {
+        return 'undefined';
+    }
+    return typeof message === 'string' ? message : JSON.stringify(error);
+}
+function hasMessage(error) {
+    return typeof error === 'object' && error !== null && 'message' in error;
+}
+
+/**
+ * Round a number to a given number of decimal places.
+ *
+ * https://gist.github.com/djD-REK/2e347f5532bb22310daf450f03ec6ad8
+ */
+function round(number, decimalPlaces) {
+    const factorOfTen = Math.pow(10, decimalPlaces);
+    return Math.round(number * factorOfTen) / factorOfTen;
+}
+function firstDecimalDigit(number) {
+    if (number % 1 === 0) {
+        return 0;
+    }
+    const regExp = /\d*\.(\d)/;
+    const regExpMatchArray = number.toString().match(regExp);
+    if (regExpMatchArray === null) {
+        throw new Error(`Invalid number for regex matching: ${number}`);
+    }
+    return Number(regExpMatchArray[1]);
+}
+
 function pluralize(amount, singular, plural) {
     if (amount === 1) {
         return singular;
@@ -15150,15 +15188,8 @@ const isURL = (value) => {
 const isWord = (value) => isString(value) && /^[\w-]+$/.test(value);
 const isLabId = (value) => isString(value) && /^\d{2}-\d{6}$/.test(value);
 const isRackBarcode = (value) => isString(value) && /^[A-Z]{2}\d{8}$/.test(value);
-
-/**
- * Round a number to a given number of decimal places.
- *
- * https://gist.github.com/djD-REK/2e347f5532bb22310daf450f03ec6ad8
- */
-function round(number, decimalPlaces) {
-    const factorOfTen = Math.pow(10, decimalPlaces);
-    return Math.round(number * factorOfTen) / factorOfTen;
+function isNotNullish(value) {
+    return value != null;
 }
 
 function includesIgnoreCase(needle, haystack) {
@@ -15181,6 +15212,8 @@ exports.ISO_DATE_FORMAT = ISO_DATE_FORMAT;
 exports.ISO_DATE_TIME_FORMAT = ISO_DATE_TIME_FORMAT;
 exports.SECONDLESS_DATE_TIME_FORMAT = SECONDLESS_DATE_TIME_FORMAT;
 exports.containSameValues = containSameValues;
+exports.errorMessage = errorMessage;
+exports.firstDecimalDigit = firstDecimalDigit;
 exports.firstLine = firstLine;
 exports.formatDotlessDate = formatDotlessDate;
 exports.formatGerman = formatGerman;
@@ -15197,6 +15230,7 @@ exports.isEmail = isEmail;
 exports.isFuture = isFuture;
 exports.isLabId = isLabId;
 exports.isNonEmptyArray = isNonEmptyArray;
+exports.isNotNullish = isNotNullish;
 exports.isOnlyDigits = isOnlyDigits;
 exports.isRackBarcode = isRackBarcode;
 exports.isString = isString;