@mll-lab/js-utils 2.2.0 → 2.6.0

package/dist/array.d.ts

@@ -1,3 +1,7 @@
+export declare type NonEmptyArray<T> = Array<T> & {
+    0: T;
+};
+export declare function isNonEmptyArray<T>(value: Array<T>): value is NonEmptyArray<T>;
 /**
  * Return a new array that does not contain the item at the specified index.
  */
@@ -18,3 +22,4 @@ export declare const EMPTY_ARRAY: never[];
  * @example const arr = ['x', ...insertIf(foo === 42, 'y', 'z')]
  */
 export declare function insertIf<T>(condition: boolean, ...elements: Array<T>): Array<T>;
+export declare function last<T, A extends Array<T>>(array: A): A extends NonEmptyArray<T> ? T : T | undefined;

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/error.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.common.js

@@ -9432,6 +9432,9 @@ if(freeModule){// Export for Node.js.
 freeExports._=_;}else {// Export to the global object.
 root._=_;}}).call(commonjsGlobal);});
 
+function isNonEmptyArray(value) {
+    return value.length > 0;
+}
 /**
  * Return a new array that does not contain the item at the specified index.
  */
@@ -9459,6 +9462,10 @@ Object.freeze(EMPTY_ARRAY);
 function insertIf(condition, ...elements) {
     return condition ? elements : [];
 }
+function last(array) {
+    // @ts-expect-error too magical
+    return array[array.length - 1];
+}
 
 function toInteger(dirtyNumber) {
   if (dirtyNumber === null || dirtyNumber === true || dirtyNumber === false) {
@@ -15104,6 +15111,23 @@ 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;
+}
+
 function pluralize(amount, singular, plural) {
     if (amount === 1) {
         return singular;
@@ -15143,6 +15167,9 @@ 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);
+function isNotNullish(value) {
+    return value != null;
+}
 
 /**
  * Round a number to a given number of decimal places.
@@ -15154,6 +15181,16 @@ function round(number, decimalPlaces) {
     return Math.round(number * factorOfTen) / factorOfTen;
 }
 
+function includesIgnoreCase(needle, haystack) {
+    if (haystack instanceof Array) {
+        return haystack.some((hay) => includesIgnoreCase(needle, hay));
+    }
+    return haystack.toLowerCase().includes(needle.toLowerCase());
+}
+function firstLine(multilineText) {
+    return multilineText.split('\n', 1)[0];
+}
+
 exports.DOTLESS_DATE_FORMAT = DOTLESS_DATE_FORMAT;
 exports.EMAIL_REGEX = EMAIL_REGEX;
 exports.EMPTY_ARRAY = EMPTY_ARRAY;
@@ -15164,6 +15201,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.firstLine = firstLine;
 exports.formatDotlessDate = formatDotlessDate;
 exports.formatGerman = formatGerman;
 exports.formatGermanDateTime = formatGermanDateTime;
@@ -15171,18 +15210,22 @@ exports.formatGermanDotlessDate = formatGermanDotlessDate;
 exports.formatIsoDate = formatIsoDate;
 exports.formatIsoDateTime = formatIsoDateTime;
 exports.formatSecondlessDateTime = formatSecondlessDateTime;
+exports.includesIgnoreCase = includesIgnoreCase;
 exports.insertIf = insertIf;
 exports.isAlphanumeric = isAlphanumeric;
 exports.isBSNR = isBSNR;
 exports.isEmail = isEmail;
 exports.isFuture = isFuture;
 exports.isLabId = isLabId;
+exports.isNonEmptyArray = isNonEmptyArray;
+exports.isNotNullish = isNotNullish;
 exports.isOnlyDigits = isOnlyDigits;
 exports.isRackBarcode = isRackBarcode;
 exports.isString = isString;
 exports.isToday = isToday;
 exports.isURL = isURL;
 exports.isWord = isWord;
+exports.last = last;
 exports.parseDate = parseDate;
 exports.parseDotlessDate = parseDotlessDate;
 exports.parseGermanDate = parseGermanDate;