@entros/pulse-sdk 1.5.0 → 1.5.2

package/README.md

@@ -5,6 +5,8 @@
 
 Client-side SDK for the Entros Protocol. Captures behavioral biometrics (voice, motion, touch), extracts 134 statistical features, generates a Groth16 zero-knowledge proof, and submits for on-chain verification on Solana. Raw biometric data stays on-device — only derived features and the proof are transmitted.
 
+> **Looking for a drop-in?** Most integrators want [`@entros/verify`](https://github.com/entros-protocol/entros-verify) — a popup-pattern React component that wraps this SDK and ships verification in five lines of JSX. Use this package directly when you need to own the verification UX (custom capture canvas, branded loading states, mobile-native).
+
 ## Install
 
 ```bash

package/dist/index.js

@@ -599,6 +599,26 @@ function extractFormantRatios(samples, sampleRate, frameSize, hopSize) {
   return { f1f2, f2f3 };
 }
 
+// src/yield.ts
+function yieldToMainThread() {
+  return new Promise((resolve) => {
+    if (typeof MessageChannel !== "undefined") {
+      const channel = new MessageChannel();
+      channel.port1.onmessage = () => {
+        channel.port1.close();
+        resolve();
+      };
+      channel.port2.postMessage(null);
+      return;
+    }
+    if (typeof setTimeout !== "undefined") {
+      setTimeout(resolve, 0);
+      return;
+    }
+    resolve();
+  });
+}
+
 // src/extraction/speaker.ts
 function getFrameSize(sampleRate) {
   const MIN_F0 = 50;
@@ -632,6 +652,7 @@ async function getMeyda() {
   }
   return meydaModule.default ?? meydaModule;
 }
+var F0_YIELD_EVERY_N_FRAMES = 16;
 async function detectF0Contour(samples, sampleRate) {
   const detect = await getPitchDetector(sampleRate);
   const frameSize = getFrameSize(sampleRate);
@@ -658,6 +679,9 @@ async function detectF0Contour(samples, sampleRate) {
       sum += (frame[j] ?? 0) * (frame[j] ?? 0);
     }
     amplitudes.push(Math.sqrt(sum / frame.length));
+    if (i > 0 && i < numFrames - 1 && i % F0_YIELD_EVERY_N_FRAMES === 0) {
+      await yieldToMainThread();
+    }
   }
   return { f0, amplitudes, periods };
 }
@@ -831,6 +855,7 @@ async function extractSpeakerFeaturesDetailed(audio) {
     normalizedSamples = samples;
   }
   const { f0, amplitudes: normalizedAmplitudes, periods } = await detectF0Contour(normalizedSamples, sampleRate);
+  await yieldToMainThread();
   const amplitudes = [];
   for (let i = 0; i < numFrames; i++) {
     const start = i * hopSize;
@@ -855,6 +880,7 @@ async function extractSpeakerFeaturesDetailed(audio) {
   const hnrStats = condense(hnrValues);
   const hnrEntropy = entropy(hnrValues);
   const hnrFeatures = [hnrStats.mean, hnrStats.variance, hnrStats.skewness, hnrStats.kurtosis, hnrEntropy];
+  await yieldToMainThread();
   const { f1f2, f2f3 } = extractFormantRatios(normalizedSamples, sampleRate, frameSize, hopSize);
   const f1f2Stats = condense(f1f2);
   const f2f3Stats = condense(f2f3);
@@ -868,6 +894,7 @@ async function extractSpeakerFeaturesDetailed(audio) {
     f2f3Stats.skewness,
     f2f3Stats.kurtosis
   ];
+  await yieldToMainThread();
   const ltasFeatures = await computeLTAS(samples, sampleRate);
   const voicingFeatures = [voicedRatio];
   const ampStats = condense(amplitudes);
@@ -4302,10 +4329,13 @@ async function extractFeatures(data) {
   const { features: audioFeatures, f0Contour } = await extractSpeakerFeaturesDetailed(
     data.audio
   );
+  await yieldToMainThread();
   const hasMotion = data.motion.length >= MIN_MOTION_SAMPLES;
   const hasTouch = data.touch.length >= MIN_TOUCH_SAMPLES;
   const motionFeatures = hasMotion && hasTouch ? extractMouseDynamics(data.touch) : hasMotion ? extractMotionFeatures(data.motion) : extractMouseDynamics(data.touch);
+  await yieldToMainThread();
   const touchFeatures = extractTouchFeatures(data.touch);
+  await yieldToMainThread();
   const accelMagnitude = hasMotion && f0Contour.length > 0 ? extractAccelerationMagnitude(data.motion, f0Contour.length) : [];
   return {
     raw: fuseRawFeatures(audioFeatures, motionFeatures, touchFeatures),
@@ -4319,6 +4349,7 @@ var MIN_MOTION_SAMPLES = 10;
 var MIN_TOUCH_SAMPLES = 10;
 async function extractFingerprintAndValidate(sensorData, config, walletAddress, onProgress) {
   onProgress?.("Extracting features...");
+  await yieldToMainThread();
   const {
     raw: features,
     normalized: normalizedFeatures,
@@ -4333,6 +4364,7 @@ async function extractFingerprintAndValidate(sensorData, config, walletAddress,
   const tbh = await generateTBH(fingerprint);
   let signedReceipt;
   onProgress?.("Validating...");
+  await yieldToMainThread();
   if (config.relayerUrl && walletAddress) {
     try {
       const baseUrl = new URL(config.relayerUrl);