@lowentry/utils 1.3.2 → 1.5.1

package/LeUtils.js

@@ -1490,7 +1490,7 @@ export const LeUtils = {
 		},
 	
 	/**
-	 * Generates a string that is guaranteed to be unique (across the entire frontend).
+	 * Generates a base64 string (with +/ replaced by -_) that is guaranteed to be unique.
 	 *
 	 * @returns {string}
 	 */
@@ -1590,6 +1590,58 @@ export const LeUtils = {
 			};
 		})(),
 	
+	/**
+	 * Generates a base64 string (with +/ replaced by -_) of the current time (in milliseconds since 1970).
+	 *
+	 * @param {number} [now] Optional time to use instead of the current time. If not set, the current time will be used.
+	 * @returns {string}
+	 */
+	timestamp:
+		(() =>
+		{
+			const numberToBytes = (number) =>
+			{
+				const size = (number === 0) ? 0 : Math.ceil((Math.floor(Math.log2(number)) + 1) / 8);
+				const bytes = new Uint8ClampedArray(size);
+				let x = number;
+				for(let i = (size - 1); i >= 0; i--)
+				{
+					const rightByte = x & 0xff;
+					bytes[i] = rightByte;
+					x = Math.floor(x / 0x100);
+				}
+				return bytes;
+			};
+			
+			return (now = null) =>
+			{
+				if(ISSET(now))
+				{
+					now = FLOAT_LAX(now);
+				}
+				else
+				{
+					try
+					{
+						// noinspection JSDeprecatedSymbols
+						now = (performance.timeOrigin || performance.timing.navigationStart) + performance.now();
+						if(typeof now !== 'number')
+						{
+							throw new Error();
+						}
+					}
+					catch(e)
+					{
+						now = (Date.now ? Date.now() : (new Date()).getTime());
+					}
+				}
+				now = Math.round(now);
+				const nowBytes = numberToBytes(now);
+				
+				return LeUtils.bytesToBase64(nowBytes).replace(/=/g, '').replace(/\+/g, '-').replace(/\//g, '_');
+			};
+		})(),
+	
 	/**
 	 * Returns a data URL of a 1x1 transparent pixel.
 	 *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowentry/utils",
-  "version": "1.3.2",
+  "version": "1.5.1",
   "private": false,
   "type": "module",
   "description": "Provides utilities for general JavaScript development.",