@iam-protocol/pulse-sdk 0.2.0 → 0.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iam-protocol/pulse-sdk",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Client-side SDK for IAM Protocol — sensor capture, TBH generation, ZK proof construction",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/challenge/lissajous.ts

@@ -54,3 +54,32 @@ export function generateLissajousPoints(params: LissajousParams): Point2D[] {
 
   return result;
 }
+
+/**
+ * Generate a sequence of Lissajous curves for dynamic mid-session switching.
+ * Each curve uses different parameters, preventing pre-computation.
+ */
+export function generateLissajousSequence(
+  count: number = 2
+): { params: LissajousParams; points: Point2D[] }[] {
+  const allRatios: [number, number][] = [
+    [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: { params: LissajousParams; points: Point2D[] }[] = [];
+
+  for (let i = 0; i < count; i++) {
+    const pair = shuffled[i % shuffled.length]!;
+    const params: LissajousParams = {
+      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;
+}

package/src/challenge/phrase.ts

@@ -17,7 +17,7 @@ const SYLLABLES = [
 export function generatePhrase(wordCount: number = 5): string {
   const words: string[] = [];
   for (let w = 0; w < wordCount; w++) {
-    const syllableCount = 2 + Math.floor(Math.random() * 2); // 2-3 syllables per word
+    const syllableCount = 2 + Math.floor(Math.random() * 2);
     let word = "";
     for (let s = 0; s < syllableCount; s++) {
       const idx = Math.floor(Math.random() * SYLLABLES.length);
@@ -27,3 +27,36 @@ export function generatePhrase(wordCount: number = 5): string {
   }
   return words.join(" ");
 }
+
+/**
+ * Generate a sequence of phrases for dynamic mid-session switching.
+ * Each phrase uses a different syllable subset to prevent pre-computation.
+ */
+export function generatePhraseSequence(
+  count: number = 3,
+  wordCount: number = 4
+): string[] {
+  const subsetSize = Math.floor(SYLLABLES.length / count);
+  const phrases: string[] = [];
+
+  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: string[] = [];
+    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;
+}

package/src/index.ts

@@ -38,6 +38,6 @@ export { fetchIdentityState, storeVerificationData, loadVerificationData } from
 export type { AudioCapture, MotionSample, TouchSample, SensorData, CaptureOptions, CaptureStage, StageState } from "./sensor/types";
 
 // Challenge
-export { generatePhrase } from "./challenge/phrase";
-export { randomLissajousParams, generateLissajousPoints } from "./challenge/lissajous";
+export { generatePhrase, generatePhraseSequence } from "./challenge/phrase";
+export { randomLissajousParams, generateLissajousPoints, generateLissajousSequence } from "./challenge/lissajous";
 export type { LissajousParams, Point2D } from "./challenge/lissajous";

package/src/pulse.ts

@@ -189,13 +189,14 @@ export class PulseSession {
 
   // --- Audio ---
 
-  async startAudio(): Promise<void> {
+  async startAudio(onAudioLevel?: (rms: number) => void): Promise<void> {
     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,
+      onAudioLevel,
     }).catch(() => null);
   }
 

package/src/sensor/audio.ts

@@ -19,6 +19,7 @@ export async function captureAudio(
     signal,
     minDurationMs = MIN_CAPTURE_MS,
     maxDurationMs = MAX_CAPTURE_MS,
+    onAudioLevel,
   } = options;
 
   const stream = await navigator.mediaDevices.getUserMedia({
@@ -42,7 +43,14 @@ export async function captureAudio(
     const processor = ctx.createScriptProcessor(bufferSize, 1, 1);
 
     processor.onaudioprocess = (e: AudioProcessingEvent) => {
-      chunks.push(new Float32Array(e.inputBuffer.getChannelData(0)));
+      const data = e.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);

package/src/sensor/types.ts

@@ -34,6 +34,8 @@ export 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 */