@vpmedia/simplify 1.70.0 → 1.71.0

package/CHANGELOG.md

@@ -1,3 +1,19 @@
+## [1.71.0] - 2026-02-05
+
+### 🚜 Refactor
+
+- Improve uuidv4 generator
+
+### 🧪 Testing
+
+- Adjusted uuid test
+- Improve uuid tests
+
+### ⚙️ Miscellaneous Tasks
+
+- Release
+- Regenerate types and source maps
+- *(release)* V1.71.0
 ## [1.70.0] - 2026-02-04
 
 ### 🚀 Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpmedia/simplify",
-  "version": "1.70.0",
+  "version": "1.71.0",
   "description": "@vpmedia/simplify",
   "author": "Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)",
   "license": "MIT",

package/src/util/uuid.js

@@ -1,19 +1,37 @@
 /* eslint-disable no-bitwise, unicorn/number-literal-case */
 
-export const hex = (s, b) => s + (b >>> 4).toString(16) + (b & 0b1111).toString(16);
+/**
+ * Convert a byte (0–255) to a 2‑character hex string.
+ * @param {number} byte - Byte value.
+ * @returns {string} Hex value.
+ */
+export const byteToHex = (byte) => (byte >>> 4).toString(16) + (byte & 0b1111).toString(16);
 
+/**
+ * UUIDv4 fallback generator (RFC 4122 compliant).
+ * @returns {string} UUIDv4 string.
+ */
 export const randomUUIDFallback = () => {
-  const r = crypto.getRandomValues
+  const bytes = crypto.getRandomValues
     ? crypto.getRandomValues(new Uint8Array(16))
     : Array.from({ length: 16 }, () => Math.floor(Math.random() * 256));
-  r[6] = (r[6] & 0x0f) | 0x40;
-  r[8] = (r[8] & 0x3f) | 0x80;
-  return [...r].reduce((uuid, b, i) => uuid + hex(i === 4 || i === 6 || i === 8 || i === 10 ? '-' : '', b), '');
-};
 
-if (!crypto.randomUUID) {
-  // @ts-expect-error
-  crypto.randomUUID = randomUUIDFallback;
-}
+  // RFC 4122 version & variant bits
+  bytes[6] = (bytes[6] & 0x0f) | 0x40;
+  bytes[8] = (bytes[8] & 0x3f) | 0x80;
+
+  let uuid = '';
+  for (const [index, byte] of bytes.entries()) {
+    if (index === 4 || index === 6 || index === 8 || index === 10) {
+      uuid += '-';
+    }
+    uuid += byteToHex(byte);
+  }
+  return uuid;
+};
 
-export const uuidv4 = () => crypto.randomUUID();
+/**
+ * Crypto UUIDv4 wrapper with fallback.
+ * @returns {string} UUIDv4 string.
+ */
+export const uuidv4 = () => (typeof crypto.randomUUID === 'function' ? crypto.randomUUID() : randomUUIDFallback());

package/src/util/uuid.test.js

@@ -33,7 +33,21 @@ describe('UUID functions', () => {
   });
 
   it('randomUUIDFallback fallback works if crypto.randomUUID not available', () => {
+    delete crypto.randomUUID;
     const uuid = randomUUIDFallback();
     expect(uuid).toMatch(uuidV4Regex);
   });
+
+  it('randomUUIDFallback does not generate duplicates', () => {
+    const uuidMap = new Map();
+    const numSamples = 1000;
+    for (let i = 0; i < numSamples; i += 1) {
+      const uuid = randomUUIDFallback();
+      if (uuidMap.has(uuid)) {
+        throw new Error('Duplicate UUIDv4 found');
+      }
+      uuidMap.set(uuid, true);
+    }
+    expect(uuidMap.size).toBe(numSamples);
+  });
 });

package/types/util/uuid.d.ts

@@ -1,4 +1,4 @@
-export function hex(s: any, b: any): string;
+export function byteToHex(byte: number): string;
 export function randomUUIDFallback(): string;
-export function uuidv4(): `${string}-${string}-${string}-${string}-${string}`;
+export function uuidv4(): string;
 //# sourceMappingURL=uuid.d.ts.map

package/types/util/uuid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../src/util/uuid.js"],"names":[],"mappings":"AAEO,4CAA4E;AAE5E,6CAON;AAOM,8EAAwC"}
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../src/util/uuid.js"],"names":[],"mappings":"AAOO,gCAHI,MAAM,GACJ,MAAM,CAEwE;AAMpF,sCAFM,MAAM,CAmBlB;AAMM,0BAFM,MAAM,CAE+F"}