@iam-protocol/pulse-sdk 0.2.0 → 0.2.2

package/README.md

@@ -1,5 +1,8 @@
 # @iam-protocol/pulse-sdk
 
+[![npm version](https://img.shields.io/npm/v/@iam-protocol/pulse-sdk.svg)](https://www.npmjs.com/package/@iam-protocol/pulse-sdk)
+[![npm downloads](https://img.shields.io/npm/dm/@iam-protocol/pulse-sdk.svg)](https://www.npmjs.com/package/@iam-protocol/pulse-sdk)
+
 Client-side SDK for the IAM Protocol. Captures behavioral biometrics (voice, motion, touch), generates a Temporal-Biometric Hash, produces a Groth16 zero-knowledge proof, and submits it for on-chain verification on Solana.
 
 ## Install

package/dist/index.d.mts

@@ -51,6 +51,8 @@ interface CaptureOptions {
     minDurationMs?: number;
     /** Maximum capture duration in ms. Auto-stops if signal hasn't fired. Default: 60000 */
     maxDurationMs?: number;
+    /** Called with RMS audio level (0-1) on each buffer during audio capture (~4x per second). */
+    onAudioLevel?: (rms: number) => void;
 }
 /** Stage of a capture session */
 type CaptureStage = "audio" | "motion" | "touch";
@@ -119,7 +121,7 @@ declare class PulseSession {
     private motionData;
     private touchData;
     constructor(config: ResolvedConfig, touchElement?: HTMLElement);
-    startAudio(): Promise<void>;
+    startAudio(onAudioLevel?: (rms: number) => void): Promise<void>;
     stopAudio(): Promise<AudioCapture | null>;
     skipAudio(): void;
     startMotion(): Promise<void>;
@@ -360,6 +362,11 @@ declare function loadVerificationData(): StoredVerificationData | null;
  * Each phrase is 5-6 syllable pairs, forming nonsensical but speakable words.
  */
 declare function generatePhrase(wordCount?: number): string;
+/**
+ * Generate a sequence of phrases for dynamic mid-session switching.
+ * Each phrase uses a different syllable subset to prevent pre-computation.
+ */
+declare function generatePhraseSequence(count?: number, wordCount?: number): string[];
 
 /**
  * Generate Lissajous curve points for the touch tracing challenge.
@@ -386,5 +393,13 @@ declare function randomLissajousParams(): LissajousParams;
  * Generate Lissajous curve points normalized to [0, 1] range.
  */
 declare function generateLissajousPoints(params: LissajousParams): Point2D[];
+/**
+ * Generate a sequence of Lissajous curves for dynamic mid-session switching.
+ * Each curve uses different parameters, preventing pre-computation.
+ */
+declare function generateLissajousSequence(count?: number): {
+    params: LissajousParams;
+    points: Point2D[];
+}[];
 
-export { type AudioCapture, type CaptureOptions, type CaptureStage, type CircuitInput, DEFAULT_CAPTURE_MS, DEFAULT_MIN_DISTANCE, DEFAULT_THRESHOLD, FINGERPRINT_BITS, type FeatureVector, type FusedFeatureVector, type IdentityState, type LissajousParams, MAX_CAPTURE_MS, MIN_CAPTURE_MS, type MotionSample, PROGRAM_IDS, type PackedFingerprint, type Point2D, type ProofResult, type PulseConfig, PulseSDK, PulseSession, type SensorData, type SolanaProof, type StageState, type StatsSummary, type StoredVerificationData, type SubmissionResult, type TBH, type TemporalFingerprint, type TouchSample, type VerificationResult, autocorrelation, bigintToBytes32, computeCommitment, condense, entropy, fetchIdentityState, fuseFeatures, generateLissajousPoints, generatePhrase, generateProof, generateSalt, generateSolanaProof, generateTBH, hammingDistance, kurtosis, loadVerificationData, mean, packBits, prepareCircuitInput, randomLissajousParams, serializeProof, simhash, skewness, storeVerificationData, submitViaRelayer, submitViaWallet, toBigEndian32, variance };
+export { type AudioCapture, type CaptureOptions, type CaptureStage, type CircuitInput, DEFAULT_CAPTURE_MS, DEFAULT_MIN_DISTANCE, DEFAULT_THRESHOLD, FINGERPRINT_BITS, type FeatureVector, type FusedFeatureVector, type IdentityState, type LissajousParams, MAX_CAPTURE_MS, MIN_CAPTURE_MS, type MotionSample, PROGRAM_IDS, type PackedFingerprint, type Point2D, type ProofResult, type PulseConfig, PulseSDK, PulseSession, type SensorData, type SolanaProof, type StageState, type StatsSummary, type StoredVerificationData, type SubmissionResult, type TBH, type TemporalFingerprint, type TouchSample, type VerificationResult, autocorrelation, bigintToBytes32, computeCommitment, condense, entropy, fetchIdentityState, fuseFeatures, generateLissajousPoints, generateLissajousSequence, generatePhrase, generatePhraseSequence, generateProof, generateSalt, generateSolanaProof, generateTBH, hammingDistance, kurtosis, loadVerificationData, mean, packBits, prepareCircuitInput, randomLissajousParams, serializeProof, simhash, skewness, storeVerificationData, submitViaRelayer, submitViaWallet, toBigEndian32, variance };

package/dist/index.d.ts

@@ -51,6 +51,8 @@ interface CaptureOptions {
     minDurationMs?: number;
     /** Maximum capture duration in ms. Auto-stops if signal hasn't fired. Default: 60000 */
     maxDurationMs?: number;
+    /** Called with RMS audio level (0-1) on each buffer during audio capture (~4x per second). */
+    onAudioLevel?: (rms: number) => void;
 }
 /** Stage of a capture session */
 type CaptureStage = "audio" | "motion" | "touch";
@@ -119,7 +121,7 @@ declare class PulseSession {
     private motionData;
     private touchData;
     constructor(config: ResolvedConfig, touchElement?: HTMLElement);
-    startAudio(): Promise<void>;
+    startAudio(onAudioLevel?: (rms: number) => void): Promise<void>;
     stopAudio(): Promise<AudioCapture | null>;
     skipAudio(): void;
     startMotion(): Promise<void>;
@@ -360,6 +362,11 @@ declare function loadVerificationData(): StoredVerificationData | null;
  * Each phrase is 5-6 syllable pairs, forming nonsensical but speakable words.
  */
 declare function generatePhrase(wordCount?: number): string;
+/**
+ * Generate a sequence of phrases for dynamic mid-session switching.
+ * Each phrase uses a different syllable subset to prevent pre-computation.
+ */
+declare function generatePhraseSequence(count?: number, wordCount?: number): string[];
 
 /**
  * Generate Lissajous curve points for the touch tracing challenge.
@@ -386,5 +393,13 @@ declare function randomLissajousParams(): LissajousParams;
  * Generate Lissajous curve points normalized to [0, 1] range.
  */
 declare function generateLissajousPoints(params: LissajousParams): Point2D[];
+/**
+ * Generate a sequence of Lissajous curves for dynamic mid-session switching.
+ * Each curve uses different parameters, preventing pre-computation.
+ */
+declare function generateLissajousSequence(count?: number): {
+    params: LissajousParams;
+    points: Point2D[];
+}[];
 
-export { type AudioCapture, type CaptureOptions, type CaptureStage, type CircuitInput, DEFAULT_CAPTURE_MS, DEFAULT_MIN_DISTANCE, DEFAULT_THRESHOLD, FINGERPRINT_BITS, type FeatureVector, type FusedFeatureVector, type IdentityState, type LissajousParams, MAX_CAPTURE_MS, MIN_CAPTURE_MS, type MotionSample, PROGRAM_IDS, type PackedFingerprint, type Point2D, type ProofResult, type PulseConfig, PulseSDK, PulseSession, type SensorData, type SolanaProof, type StageState, type StatsSummary, type StoredVerificationData, type SubmissionResult, type TBH, type TemporalFingerprint, type TouchSample, type VerificationResult, autocorrelation, bigintToBytes32, computeCommitment, condense, entropy, fetchIdentityState, fuseFeatures, generateLissajousPoints, generatePhrase, generateProof, generateSalt, generateSolanaProof, generateTBH, hammingDistance, kurtosis, loadVerificationData, mean, packBits, prepareCircuitInput, randomLissajousParams, serializeProof, simhash, skewness, storeVerificationData, submitViaRelayer, submitViaWallet, toBigEndian32, variance };
+export { type AudioCapture, type CaptureOptions, type CaptureStage, type CircuitInput, DEFAULT_CAPTURE_MS, DEFAULT_MIN_DISTANCE, DEFAULT_THRESHOLD, FINGERPRINT_BITS, type FeatureVector, type FusedFeatureVector, type IdentityState, type LissajousParams, MAX_CAPTURE_MS, MIN_CAPTURE_MS, type MotionSample, PROGRAM_IDS, type PackedFingerprint, type Point2D, type ProofResult, type PulseConfig, PulseSDK, PulseSession, type SensorData, type SolanaProof, type StageState, type StatsSummary, type StoredVerificationData, type SubmissionResult, type TBH, type TemporalFingerprint, type TouchSample, type VerificationResult, autocorrelation, bigintToBytes32, computeCommitment, condense, entropy, fetchIdentityState, fuseFeatures, generateLissajousPoints, generateLissajousSequence, generatePhrase, generatePhraseSequence, generateProof, generateSalt, generateSolanaProof, generateTBH, hammingDistance, kurtosis, loadVerificationData, mean, packBits, prepareCircuitInput, randomLissajousParams, serializeProof, simhash, skewness, storeVerificationData, submitViaRelayer, submitViaWallet, toBigEndian32, variance };

package/dist/index.js

@@ -12994,7 +12994,9 @@ __export(index_exports, {
   fetchIdentityState: () => fetchIdentityState,
   fuseFeatures: () => fuseFeatures,
   generateLissajousPoints: () => generateLissajousPoints,
+  generateLissajousSequence: () => generateLissajousSequence,
   generatePhrase: () => generatePhrase,
+  generatePhraseSequence: () => generatePhraseSequence,
   generateProof: () => generateProof,
   generateSalt: () => generateSalt,
   generateSolanaProof: () => generateSolanaProof,
@@ -13047,7 +13049,8 @@ async function captureAudio(options = {}) {
   const {
     signal,
     minDurationMs = MIN_CAPTURE_MS,
-    maxDurationMs = MAX_CAPTURE_MS
+    maxDurationMs = MAX_CAPTURE_MS,
+    onAudioLevel
   } = options;
   const stream = await navigator.mediaDevices.getUserMedia({
     audio: {
@@ -13067,7 +13070,13 @@ async function captureAudio(options = {}) {
     const bufferSize = 4096;
     const processor = ctx.createScriptProcessor(bufferSize, 1, 1);
     processor.onaudioprocess = (e2) => {
-      chunks.push(new Float32Array(e2.inputBuffer.getChannelData(0)));
+      const data = e2.inputBuffer.getChannelData(0);
+      chunks.push(new Float32Array(data));
+      if (onAudioLevel) {
+        let sum = 0;
+        for (let i = 0; i < data.length; i++) sum += data[i] * data[i];
+        onAudioLevel(Math.sqrt(sum / data.length));
+      }
     };
     source.connect(processor);
     processor.connect(ctx.destination);
@@ -13937,13 +13946,14 @@ var PulseSession = class {
     this.touchElement = touchElement;
   }
   // --- Audio ---
-  async startAudio() {
+  async startAudio(onAudioLevel) {
     if (this.audioStageState !== "idle")
       throw new Error("Audio capture already started");
     this.audioStageState = "capturing";
     this.audioController = new AbortController();
     this.audioPromise = captureAudio({
-      signal: this.audioController.signal
+      signal: this.audioController.signal,
+      onAudioLevel
     }).catch(() => null);
   }
   async stopAudio() {
@@ -14191,6 +14201,28 @@ function generatePhrase(wordCount = 5) {
   }
   return words.join(" ");
 }
+function generatePhraseSequence(count = 3, wordCount = 4) {
+  const subsetSize = Math.floor(SYLLABLES.length / count);
+  const phrases = [];
+  for (let p = 0; p < count; p++) {
+    const start = p * subsetSize % SYLLABLES.length;
+    const subset = [
+      ...SYLLABLES.slice(start, start + subsetSize),
+      ...SYLLABLES.slice(0, Math.max(0, start + subsetSize - SYLLABLES.length))
+    ];
+    const words = [];
+    for (let w = 0; w < wordCount; w++) {
+      const syllableCount = 2 + Math.floor(Math.random() * 2);
+      let word = "";
+      for (let s = 0; s < syllableCount; s++) {
+        word += subset[Math.floor(Math.random() * subset.length)];
+      }
+      words.push(word);
+    }
+    phrases.push(words.join(" "));
+  }
+  return phrases;
+}
 
 // src/challenge/lissajous.ts
 function randomLissajousParams() {
@@ -14221,6 +14253,33 @@ function generateLissajousPoints(params) {
   }
   return result;
 }
+function generateLissajousSequence(count = 2) {
+  const allRatios = [
+    [1, 2],
+    [2, 3],
+    [3, 4],
+    [3, 5],
+    [4, 5],
+    [1, 3],
+    [2, 5],
+    [5, 6],
+    [3, 7],
+    [4, 7]
+  ];
+  const shuffled = [...allRatios].sort(() => Math.random() - 0.5);
+  const sequence = [];
+  for (let i = 0; i < count; i++) {
+    const pair = shuffled[i % shuffled.length];
+    const params = {
+      a: pair[0],
+      b: pair[1],
+      delta: Math.PI * (0.1 + Math.random() * 0.8),
+      points: 200
+    };
+    sequence.push({ params, points: generateLissajousPoints(params) });
+  }
+  return sequence;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_CAPTURE_MS,
@@ -14240,7 +14299,9 @@ function generateLissajousPoints(params) {
   fetchIdentityState,
   fuseFeatures,
   generateLissajousPoints,
+  generateLissajousSequence,
   generatePhrase,
+  generatePhraseSequence,
   generateProof,
   generateSalt,
   generateSolanaProof,