@softsky/utils 2.4.0 → 2.5.1

package/README.md

@@ -107,7 +107,14 @@ ${\textsf{\color{ForestGreen}const}}$ SEC_MS - Milliseconds in a second
 ## Control
 Utils related to code execution flow.
 
-${\textsf{\color{ForestGreen}const}}$ UUID - Get unique id
+${\textsf{\color{ForestGreen}const}}$ generateNumberId - Get unique number id
+
+---
+${\textsf{\color{CornflowerBlue}function}}$ UUID - Get universally unique string id.
+You can get information then id was generated using extractUUIDDate(uuid)
+
+---
+${\textsf{\color{CornflowerBlue}function}}$ extractUUIDDate - Extract exact date of uuid generation
 
 ---
 ${\textsf{\color{CornflowerBlue}function}}$ createCashedFunction - Creates cached function. All arguments/results are cached.

package/dist/control.d.ts

@@ -2,8 +2,15 @@
  * Utils related to code execution flow.
  */
 import { AwaitedObject, JSONSerializable } from './types';
-/** Get unique id */
-export declare const UUID: () => number;
+/** Get unique number id */
+export declare const generateNumberId: () => number;
+/**
+ * Get universally unique string id.
+ * You can get information then id was generated using extractUUIDDate(uuid)
+ */
+export declare function UUID(): string;
+/** Extract exact date of uuid generation */
+export declare function extractUUIDDate(uuid: string): Date;
 /**
  * Creates cached function. All arguments/results are cached.
  * Returns [

package/dist/control.js

@@ -1,9 +1,26 @@
 /**
  * Utils related to code execution flow.
  */
+let stringIdInc = 0;
 let _uuid = Date.now() * 1000;
-/** Get unique id */
-export const UUID = () => _uuid++;
+/** Get unique number id */
+export const generateNumberId = () => _uuid++;
+const SESSION_ID = ((Math.random() * 2_147_483_648) | 0).toString(16);
+/**
+ * Get universally unique string id.
+ * You can get information then id was generated using extractUUIDDate(uuid)
+ */
+export function UUID() {
+    if (stringIdInc === 46_655)
+        stringIdInc = 0;
+    else
+        stringIdInc++;
+    return `${Date.now().toString(36).padStart(11, '0')}${(++stringIdInc).toString(36).padStart(3, '0')}${SESSION_ID}`;
+}
+/** Extract exact date of uuid generation */
+export function extractUUIDDate(uuid) {
+    return new Date(Number.parseInt(uuid.slice(0, 11), 36));
+}
 /**
  * Creates cached function. All arguments/results are cached.
  * Returns [

package/package.json

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