@vpmedia/simplify 1.68.0 → 1.70.0

package/CHANGELOG.md

@@ -1,3 +1,23 @@
+## [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
+
+- Fixed export name
+
+### ⚙️ Miscellaneous Tasks
+
+- Release
+- *(release)* V1.69.0
 ## [1.68.0] - 2026-02-04
 
 ### 🚜 Refactor

package/package.json

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

package/src/index.js

@@ -21,7 +21,7 @@ export { TypeCheckError } from './typecheck/TypeCheckError.js';
 export { typeCheck, typeCheckArray, typeCheckEnum } from './typecheck/util.js';
 export { delayPromise, loadJSON } from './util/async.js';
 export { getErrorDetails, getTypedError } from './util/error.js';
-export { EventEmitter as EventEmitter3 } from './util/event_emitter.js';
+export { EventEmitter } from './util/event_emitter.js';
 export { FetchError, fetchRetry, HTTP_0_ANY } from './util/fetch.js';
 export {
   deg2rad,
@@ -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,19 @@
+/* eslint-disable no-bitwise, unicorn/number-literal-case */
+
+export const hex = (s, b) => s + (b >>> 4).toString(16) + (b & 0b1111).toString(16);
+
+export const randomUUIDFallback = () => {
+  const r = 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;
+}
+
+export const uuidv4 = () => crypto.randomUUID();

package/src/util/uuid.test.js

@@ -0,0 +1,39 @@
+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', () => {
+    const uuid = randomUUIDFallback();
+    expect(uuid).toMatch(uuidV4Regex);
+  });
+});

package/types/index.d.ts

@@ -10,8 +10,9 @@ export { OpenTelemetryLogHandler } from "./logging/OpenTelemetryLogHandler.js";
 export { SentryLogHandler } from "./logging/SentryLogHandler.js";
 export { typeChecker } from "./typecheck/TypeChecker.js";
 export { TypeCheckError } from "./typecheck/TypeCheckError.js";
-export { EventEmitter as EventEmitter3 } from "./util/event_emitter.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 hex(s: any, b: any): string;
+export function randomUUIDFallback(): string;
+export function uuidv4(): `${string}-${string}-${string}-${string}-${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":"AAEO,4CAA4E;AAE5E,6CAON;AAOM,8EAAwC"}