@vpmedia/simplify 1.69.0 → 1.71.0

package/CHANGELOG.md

@@ -1,3 +1,29 @@
+## [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
+
+- Added uuidv4 generator
+
+### ⚙️ Miscellaneous Tasks
+
+- Release
+- *(release)* V1.70.0
 ## [1.69.0] - 2026-02-04
 
 ### 🐛 Bug Fixes

package/package.json

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

package/src/index.js

@@ -39,4 +39,5 @@ export { deepMerge, getObjArrayPropSum, getObjValueByPath, purgeObject, setObjVa
 export { getURLParam, sanitizeURLParam } from './util/query.js';
 export { serverDataToState } from './util/state.js';
 export { addLeadingZero, capitalize, getTypeFromValue, saveAsFile, underscoreToCamelCase } from './util/string.js';
+export { uuidv4 } from './util/uuid.js';
 export * from './util/validate.js';

package/src/util/uuid.js

@@ -0,0 +1,37 @@
+/* eslint-disable no-bitwise, unicorn/number-literal-case */
+
+/**
+ * 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 bytes = crypto.getRandomValues
+    ? crypto.getRandomValues(new Uint8Array(16))
+    : Array.from({ length: 16 }, () => Math.floor(Math.random() * 256));
+
+  // 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;
+};
+
+/**
+ * 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

@@ -0,0 +1,53 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { randomUUIDFallback, uuidv4 } from './uuid.js';
+
+const uuidV4Regex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu;
+
+describe('UUID functions', () => {
+  let originalRandomUUID = null;
+
+  beforeEach(() => {
+    originalRandomUUID = crypto.randomUUID;
+  });
+
+  afterEach(() => {
+    crypto.randomUUID = originalRandomUUID;
+  });
+
+  it('randomUUIDFallback generates a valid UUID v4', () => {
+    const uuid = randomUUIDFallback();
+    expect(uuid).toMatch(uuidV4Regex);
+  });
+
+  it('uuidv4 returns a valid UUID v4', () => {
+    const uuid = uuidv4();
+    expect(uuid).toMatch(uuidV4Regex);
+  });
+
+  it('uuidv4 uses crypto.randomUUID if available', () => {
+    // @ts-expect-error
+    crypto.randomUUID = vi.fn(() => 'mock-uuid');
+    const uuid = uuidv4();
+    expect(uuid).toBe('mock-uuid');
+    expect(crypto.randomUUID).toHaveBeenCalled();
+  });
+
+  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/index.d.ts

@@ -12,6 +12,7 @@ export { typeChecker } from "./typecheck/TypeChecker.js";
 export { TypeCheckError } from "./typecheck/TypeCheckError.js";
 export { EventEmitter } from "./util/event_emitter.js";
 export { serverDataToState } from "./util/state.js";
+export { uuidv4 } from "./util/uuid.js";
 export { formatLogMessage, getLogLevelName } from "./logging/util.js";
 export { addPageLifecycleCallback, getDocumentState, getPageLifecycleEventEmitter, getPageLifecycleState, initPageLifecycle, isPageLifecycleInitialized } from "./pagelifecycle/util.js";
 export { typeCheck, typeCheckArray, typeCheckEnum } from "./typecheck/util.js";

package/types/util/uuid.d.ts

@@ -0,0 +1,4 @@
+export function byteToHex(byte: number): string;
+export function randomUUIDFallback(): string;
+export function uuidv4(): string;
+//# sourceMappingURL=uuid.d.ts.map

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

@@ -0,0 +1 @@
+{"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"}