@lowentry/utils 1.10.5 → 1.11.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowentry/utils",
-  "version": "1.10.5",
+  "version": "1.11.1",
   "private": false,
   "type": "module",
   "main": "./index.js",

package/src/LeUtils.js

@@ -45,6 +45,67 @@ export const LeUtils = {
 	 */
 	equals:FastDeepEqual,
 	
+	/**
+	 * Returns a deep copy of the given value.
+	 *
+	 * @param {*} value
+	 * @returns {*}
+	 */
+	clone:
+		(value) => CloneDeep(value, true),
+	
+	/**
+	 * Executes the given callback when the document is ready.
+	 *
+	 * @param {Function} callback
+	 * @returns {{remove:Function}}
+	 */
+	onDomReady:
+		(callback) =>
+		{
+			if((typeof window === 'undefined') || !document)
+			{
+				// no document, so we can't wait for it to be ready
+				return {
+					remove:() =>
+					       {
+					       },
+				};
+			}
+			
+			if((document.readyState === 'interactive') || (document.readyState === 'complete'))
+			{
+				return LeUtils.setTimeout(callback, 0);
+			}
+			else
+			{
+				let listening = true;
+				const callbackWrapper = () =>
+				{
+					if(listening)
+					{
+						listening = false;
+						document.removeEventListener('DOMContentLoaded', callbackWrapper);
+						callback();
+					}
+				};
+				
+				document.addEventListener('DOMContentLoaded', callbackWrapper);
+				
+				return {
+					remove:
+						() =>
+						{
+							if(listening)
+							{
+								listening = false;
+								document.removeEventListener('DOMContentLoaded', callbackWrapper);
+							}
+						},
+				};
+			}
+		},
+	
 	/**
 	 * Parses the given version string, and returns an object with the major, minor, and patch numbers, as well as some comparison functions.
 	 *
@@ -925,6 +986,15 @@ export const LeUtils = {
 	setTimeout:
 		(callback, ms) =>
 		{
+			if(typeof window === 'undefined')
+			{
+				return {
+					remove:() =>
+					       {
+					       },
+				};
+			}
+			
 			ms = FLOAT_LAX(ms);
 			
 			let lastTime = performance.now();
@@ -986,6 +1056,15 @@ export const LeUtils = {
 				}
 			}
 			
+			if(typeof window === 'undefined')
+			{
+				return {
+					remove:() =>
+					       {
+					       },
+				};
+			}
+			
 			let lastTime = performance.now();
 			let handler = setInterval(() =>
 			{
@@ -1030,6 +1109,15 @@ export const LeUtils = {
 	setAnimationFrameTimeout:
 		(callback, frames = 1) =>
 		{
+			if(typeof window === 'undefined')
+			{
+				return {
+					remove:() =>
+					       {
+					       },
+				};
+			}
+			
 			frames = INT_LAX_ANY(frames, 1);
 			
 			let run = true;
@@ -1106,6 +1194,15 @@ export const LeUtils = {
 				}
 			}
 			
+			if(typeof window === 'undefined')
+			{
+				return {
+					remove:() =>
+					       {
+					       },
+				};
+			}
+			
 			let run = true;
 			let requestAnimationFrameId = null;
 			let lastTime = performance.now();
@@ -1186,6 +1283,84 @@ export const LeUtils = {
 			return new Promise(resolve => LeUtils.setAnimationFrameTimeout(resolve, frames));
 		},
 	
+	/**
+	 * Allows you to do a fetch, with built-in retry and abort functionality.
+	 *
+	 * @param {string} url
+	 * @param {Object} [options]
+	 * @returns {{promise:Promise<*>, then:Function, catch:Function, finally:Function, remove:Function, isRemoved:Function}}
+	 */
+	fetch:
+		(url, options) =>
+		{
+			let currentRetries = 0;
+			const retries = INT_LAX(options?.retries, 0);
+			const signal = new AbortController();
+			const promise = new Promise((resolve, reject) =>
+			{
+				const attemptFetch = () =>
+				{
+					if(signal.signal.aborted)
+					{
+						reject(new Error('Aborted'));
+						return;
+					}
+					
+					fetch(url, {
+						signal,
+						...(options ?? {}),
+						retries:undefined,
+						delay:  undefined,
+					}).then((response) =>
+					{
+						if(!response.ok)
+						{
+							throw new Error('Network request failed: ' + response.status + ' ' + response.statusText);
+						}
+						return response;
+					}).then((response) =>
+					{
+						resolve(response);
+					}).catch((error) =>
+					{
+						if(currentRetries >= retries)
+						{
+							reject(error);
+							return;
+						}
+						currentRetries++;
+						setTimeout(attemptFetch, (typeof options?.delay === 'function') ? INT_LAX_ANY(options?.delay(currentRetries), 500) : (INT_LAX_ANY(options?.delay, 500)));
+					});
+				};
+				attemptFetch();
+			});
+			
+			let result = {};
+			result.promise = promise;
+			result.then = (...args) =>
+			{
+				promise.then(...args);
+				return result;
+			};
+			result.catch = (...args) =>
+			{
+				promise.catch(...args);
+				return result;
+			};
+			result.finally = (...args) =>
+			{
+				promise.finally(...args);
+				return result;
+			};
+			result.remove = (...args) =>
+			{
+				signal.abort(...args);
+				return result;
+			};
+			result.isRemoved = () => signal.signal.aborted;
+			return result;
+		},
+	
 	/**
 	 * Returns true if the user is on a smartphone device (mobile).
 	 * Will return false if the user is on a tablet or on a desktop.
@@ -1419,9 +1594,27 @@ export const LeUtils = {
 	purgeErrorMessage:
 		(error) =>
 		{
-			const message = STRING(((typeof error === 'string') ? error : (error.message ?? JSON.stringify(error))));
-			const messageParts = message.split('threw an error:');
-			return messageParts[messageParts.length - 1].trim();
+			if(error?.message)
+			{
+				error = error.message;
+			}
+			if(typeof error === 'string')
+			{
+				const errorParts = error.split('threw an error:');
+				error = errorParts[errorParts.length - 1];
+			}
+			else
+			{
+				try
+				{
+					error = JSON.stringify(error);
+				}
+				catch(e)
+				{
+					error = 'An unknown error occurred';
+				}
+			}
+			return error.trim();
 		},
 	
 	/**
@@ -1535,6 +1728,10 @@ export const LeUtils = {
 				let now;
 				try
 				{
+					if(typeof window === 'undefined')
+					{
+						throw new Error();
+					}
 					// noinspection JSDeprecatedSymbols
 					now = (performance.timeOrigin || performance.timing.navigationStart) + performance.now();
 					if(typeof now !== 'number')
@@ -1639,6 +1836,10 @@ export const LeUtils = {
 				{
 					try
 					{
+						if(typeof window === 'undefined')
+						{
+							throw new Error();
+						}
 						// noinspection JSDeprecatedSymbols
 						now = (performance.timeOrigin || performance.timing.navigationStart) + performance.now();
 						if(typeof now !== 'number')
@@ -1698,7 +1899,7 @@ export const LeUtils = {
 	getImagePixels:
 		(image) =>
 		{
-			if(!document)
+			if((typeof window === 'undefined') || !document)
 			{
 				return new Uint8ClampedArray();
 			}
@@ -1738,7 +1939,7 @@ export const LeUtils = {
 	getColoredImage:
 		(image, color) =>
 		{
-			if(!document)
+			if((typeof window === 'undefined') || !document)
 			{
 				return LeUtils.getEmptyImageSrc();
 			}
@@ -2257,6 +2458,10 @@ export const LeUtils = {
 	downloadFile:
 		(base64string, fileName, mimeType) =>
 		{
+			if((typeof window === 'undefined') || !document)
+			{
+				return;
+			}
 			const link = document.createElement('a');
 			link.setAttribute('download', (typeof fileName === 'string') ? fileName : 'file');
 			link.href = 'data:' + mimeType + ';base64,' + base64string;
@@ -2824,6 +3029,17 @@ export const LeUtils = {
 	createWorkerThread:
 		(name) =>
 		{
+			if((typeof window === 'undefined') || (typeof Worker === 'undefined'))
+			{
+				return {
+					worker:     null,
+					sendMessage:new Promise((resolve, reject) =>
+					{
+						reject('Workers are not supported in this environment');
+					}),
+				};
+			}
+			
 			const worker = new Worker('/workers/' + name + '.worker.js');
 			let listeners = {};
 			
@@ -2901,15 +3117,6 @@ export const LeUtils = {
 			};
 		})(),
 	
-	/**
-	 * Returns a deep copy of the given value.
-	 *
-	 * @param {*} value
-	 * @returns {*}
-	 */
-	clone:
-		(value) => CloneDeep(value, true),
-	
 	/**
 	 * Purges the given email address, returning an empty string if it's invalid.
 	 *
@@ -2934,6 +3141,10 @@ export const LeUtils = {
 	 */
 	isFocusClear:(() =>
 	{
+		if((typeof window === 'undefined') || !document)
+		{
+			return () => true;
+		}
 		const inputTypes = ['text', 'search', 'email', 'number', 'password', 'tel', 'time', 'url', 'week', 'month', 'date', 'datetime-local'];
 		return () => !((document?.activeElement?.tagName?.toLowerCase() === 'input') && inputTypes.includes(document?.activeElement?.type?.toLowerCase()));
 	})(),
@@ -2952,11 +3163,11 @@ export const LeUtils = {
 			{
 				userLocale = (() =>
 				{
-					if(typeof window === 'undefined')
+					if((typeof window === 'undefined') || !navigator)
 					{
 						return 'en-US';
 					}
-					let locales = window.navigator.languages;
+					let locales = navigator?.languages ?? [];
 					if(!IS_ARRAY(locales) || (locales.length <= 0))
 					{
 						return 'en-US';
@@ -2993,9 +3204,9 @@ export const LeUtils = {
 				userLocaleDateFormat = (() =>
 				{
 					let char = '/';
-					if((typeof window !== 'undefined') && (typeof Intl !== 'undefined') && (typeof Intl.DateTimeFormat !== 'undefined'))
+					if((typeof window !== 'undefined') && (typeof window.Intl !== 'undefined') && (typeof window.Intl.DateTimeFormat !== 'undefined'))
 					{
-						const formattedDate = new Intl.DateTimeFormat(LeUtils.getUserLocale()).format();
+						const formattedDate = new window.Intl.DateTimeFormat(LeUtils.getUserLocale()).format();
 						if(formattedDate.includes('-'))
 						{
 							char = '-';