@wardx/core 0.5.0 → 0.7.0

package/README.md

@@ -117,7 +117,7 @@ core.histogram('coins.award_size').observe(80, { grantId: 'g-80' });
 `timer(name, dims)` starts a timer. The returned function records the duration in milliseconds into a histogram. You can add dimensions when you stop the timer.
 
 `distinct(name, dims).add(identifier)` updates a fixed HyperLogLog sketch. The
-engine hashes the identifier as `SHA-256(privacySalt || 0x00 || identifier)` and
+engine hashes the identifier as `XXHash64(privacySalt || 0x00 || identifier)` and
 discards it immediately; the frame contains only 512 HLL registers (`p=9`,
 about 4.6% standard error). Keep `privacySalt` stable across workers and time
 windows so equal identifiers map to equal registers.
@@ -239,7 +239,7 @@ bucket = hash / 2^32
 
 If `bucket >= allocation`, `assignVariant` returns `null`.
 
-`subjectHash` returns 64 lowercase hex digits of `SHA-256(UTF8(privacySalt) || 0x00 || UTF8(subjectId))`.
+`subjectHash` returns 16 lowercase hex digits of `XXHash64(UTF8(privacySalt) || 0x00 || UTF8(subjectId))`.
 
 ## Use case 5: Build a frame for a custom transport
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wardx/core",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Runtime-agnostic Wardx engine for metrics, events, logs, Remote Config, and experiments.",
   "keywords": [
     "wardx",
@@ -40,5 +40,8 @@
   ],
   "publishConfig": {
     "access": "public"
+  },
+  "dependencies": {
+    "xxhash-wasm": "1.1.0"
   }
 }

package/src/config/hash.js

@@ -1,4 +1,6 @@
-import { createHash } from 'node:crypto';
+import xxhash from 'xxhash-wasm';
+
+const { h64ToString } = await xxhash();
 
 const encoder = new TextEncoder();
 
@@ -25,9 +27,5 @@ export function assignmentHash(experimentId, subjectId, salt) {
 }
 
 export function subjectHash(projectSalt, subjectId) {
-  return createHash('sha256')
-    .update(projectSalt, 'utf8')
-    .update('\0', 'utf8')
-    .update(subjectId, 'utf8')
-    .digest('hex');
+  return h64ToString(`${projectSalt}\0${subjectId}`);
 }

package/src/metrics/HyperLogLog.js

@@ -1,4 +1,4 @@
-import { createHash } from 'node:crypto';
+import { subjectHash } from '../config/hash.js';
 
 export const HLL_PRECISION = 9;
 export const HLL_REGISTER_COUNT = 1 << HLL_PRECISION;
@@ -82,11 +82,7 @@ export class HyperLogLog {
     if (typeof identifier !== 'string' || identifier.length === 0) {
       throw new Error('distinct.add requires a non-empty string');
     }
-    const digest = createHash('sha256')
-      .update(this.privacySalt, 'utf8')
-      .update('\0', 'utf8')
-      .update(identifier, 'utf8')
-      .digest();
+    const digest = Buffer.from(subjectHash(this.privacySalt, identifier), 'hex');
     const index = (digest[0] << 1) | (digest[1] >> 7);
     const rank = rankAfterIndex(digest);
     if (rank > this.registers[index]) this.registers[index] = rank;