Feat/uuidv5 generation

infrastructure/w3id/package.json

@@ -3,7 +3,7 @@
   "version": "1.0.0",
   "description": "",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
+    "test": "vitest",
     "dev": "tsc --watch",
     "check-format": "prettier --check \"src/**/*.ts\"",
     "format": "npx @biomejs/biome format --write ./src",
@@ -22,7 +22,10 @@
     "uuid": "^11.1.0"
   },
   "devDependencies": {
-    "typescript": "^5.8.2"
+    "@ngneat/falso": "^7.3.0",
+    "@types/node": "^22.13.10",
+    "typescript": "^5.8.2",
+    "vitest": "^3.0.9"
   },
   "main": "./dist/node/index.js",
   "module": "./dist/browser/index.js",

infrastructure/w3id/src/utils/uuid.ts

@@ -0,0 +1,17 @@
+import { v4 as uuidv4, v5 as uuidv5 } from "uuid";
+
+/**
+ * Generates a UUIDv5 taking namespace from a random UUIDv4 and taking `name`
+ * part as entropy from the creator of the identifier
+ *
+ * @param {String} entropy
+ * @param {String} namespace - uuid namespace
+ * @returns string
+ */
+
+export function generateUuid(
+  entropy: string,
+  namespace: string = uuidv4(),
+): string {
+  return uuidv5(entropy, namespace);
+}

infrastructure/w3id/tests/utils/uuid.test.ts

@@ -0,0 +1,18 @@
+import { generateUuid } from "../../src/utils/uuid";
+import falso from "@ngneat/falso";
+import { describe, test, expect } from "vitest";
+
+describe("UUIDv5 Generation", () => {
+  test("Create UUID", () => {
+    const id = generateUuid(falso.randText());
+    expect(id).toBeDefined();
+  });
+
+  test("UUID is deterministic", () => {
+    const namespace = falso.randUuid();
+    const entropy = falso.randText();
+    const id = generateUuid(entropy, namespace);
+    const id2 = generateUuid(entropy, namespace);
+    expect(id).toEqual(id2);
+  });
+});