@mll-lab/js-utils 2.40.0 → 2.41.0

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './array';
+export * from './assert';
 export * from './date';
 export * from './device';
 export * from './error';

package/dist/index.js

@@ -9623,6 +9623,28 @@ function soleItem(array) {
     return array[0];
 }
 
+/**
+ * Asserts that a value is a string at runtime.
+ * Throws an error if the value is not a string.
+ *
+ * Use this function instead of unsafe type casts like `as string` when you need
+ * to ensure a value is actually a string at runtime.
+ *
+ * @param value - The value to check
+ * @returns The value as a string if it passes the check
+ * @throws Error if the value is not a string
+ *
+ * @example
+ * const id = assertString(someUnknownValue);
+ * // Now id is safely typed as string and verified at runtime
+ */
+function assertString(value) {
+    if (typeof value !== 'string') {
+        throw new Error(`Expected a string, but got ${typeof value}`);
+    }
+    return value;
+}
+
 /**
  * @name toDate
  * @category Common Helpers
@@ -16306,6 +16328,7 @@ exports.GERMAN_THOUSAND_SEPARATOR = GERMAN_THOUSAND_SEPARATOR;
 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.assertString = assertString;
 exports.callSequentially = callSequentially;
 exports.ceil = ceil;
 exports.containSameValues = containSameValues;