@softsky/utils 2.5.0 → 2.5.2

package/README.md

@@ -107,10 +107,18 @@ ${\textsf{\color{ForestGreen}const}}$ SEC_MS - Milliseconds in a second
 ## Control
 Utils related to code execution flow.
 
-${\textsf{\color{ForestGreen}const}}$ generateNumberId - Get unique number id
+${\textsf{\color{ForestGreen}const}}$ SESSION_ID - Id generated only once per session
 
 ---
-${\textsf{\color{CornflowerBlue}function}}$ UUID - Get universally unique string id
+${\textsf{\color{CornflowerBlue}function}}$ UUID - Get universally unique string id.
+You can get information then id was generated using extractUUIDDate(uuid)
+- 13 char - timestamp
+- 13 char - SESSION_ID
+- 4 char - incremental id
+
+30 char total.
+
+USING CUSTOM TIMESTAMP MAY RESULT IN COLLISSIONS
 
 ---
 ${\textsf{\color{CornflowerBlue}function}}$ extractUUIDDate - Extract exact date of uuid generation

package/dist/control.d.ts

@@ -2,10 +2,20 @@
  * Utils related to code execution flow.
  */
 import { AwaitedObject, JSONSerializable } from './types';
-/** Get unique number id */
-export declare const generateNumberId: () => number;
-/** Get universally unique string id */
-export declare function UUID(): string;
+/** Id generated only once per session */
+export declare const SESSION_ID: string;
+/**
+ * Get universally unique string id.
+ * You can get information then id was generated using extractUUIDDate(uuid)
+ * - 13 char - timestamp
+ * - 13 char - SESSION_ID
+ * - 4 char - incremental id
+ *
+ * 30 char total.
+ *
+ * USING CUSTOM TIMESTAMP MAY RESULT IN COLLISSIONS
+ */
+export declare function UUID(timestamp?: number): string;
 /** Extract exact date of uuid generation */
 export declare function extractUUIDDate(uuid: string): Date;
 /**

package/dist/control.js

@@ -1,18 +1,33 @@
 /**
  * Utils related to code execution flow.
  */
-let _uuid = Date.now() * 1000;
-/** Get unique number id */
-export const generateNumberId = () => _uuid++;
-const SESSION_ID = ((Math.random() * 2_147_483_648) | 0).toString(16);
-let stringIdInc = 0;
-/** Get universally unique string id */
-export function UUID() {
-    return `${Date.now().toString(36).padStart(11, '0')}${(++stringIdInc).toString(36).padStart(3, '0')}${SESSION_ID}`;
+let lastIncId = Math.floor(Math.random() * 0x1_00_00);
+/** Id generated only once per session */
+export const SESSION_ID = Math.floor(Math.random() * 0x10_00_00_00_00_00_00)
+    .toString(16)
+    .padStart(13, '0');
+/**
+ * Get universally unique string id.
+ * You can get information then id was generated using extractUUIDDate(uuid)
+ * - 13 char - timestamp
+ * - 13 char - SESSION_ID
+ * - 4 char - incremental id
+ *
+ * 30 char total.
+ *
+ * USING CUSTOM TIMESTAMP MAY RESULT IN COLLISSIONS
+ */
+export function UUID(timestamp = Date.now()) {
+    let inc = (++lastIncId).toString(16).padStart(4, '0');
+    if (inc.length === 5) {
+        lastIncId = 0;
+        inc = '0000';
+    }
+    return `${timestamp.toString(16).padStart(13, '0')}${inc}${SESSION_ID}`;
 }
 /** Extract exact date of uuid generation */
 export function extractUUIDDate(uuid) {
-    return new Date(Number.parseInt(uuid.slice(0, 11), 36));
+    return new Date(Number.parseInt(uuid.slice(0, 13), 16));
 }
 /**
  * Creates cached function. All arguments/results are cached.

package/dist/formatting.js

@@ -80,7 +80,7 @@ export function formatNumber(time, min = 0, ranges = FORMAT_NUMBER_RANGES) {
             break;
         if (time < start && !pad)
             continue;
-        let value = ((time / start) | 0).toString();
+        let value = Math.floor(time / start).toString();
         time %= start;
         if (pad)
             value = value.padStart(pad, '0');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softsky/utils",
-  "version": "2.5.0",
+  "version": "2.5.2",
   "description": "JavaScript/TypeScript utilities",
   "main": "dist/index.js",
   "scripts": {