@iam-protocol/pulse-sdk 0.3.3 → 0.3.4

package/package.json

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

package/src/pulse.ts

@@ -7,7 +7,7 @@ import type { VerificationResult } from "./submit/types";
 import type { StoredVerificationData } from "./identity/types";
 
 import { captureAudio } from "./sensor/audio";
-import { captureMotion } from "./sensor/motion";
+import { captureMotion, requestMotionPermission } from "./sensor/motion";
 import { captureTouch } from "./sensor/touch";
 import { extractSpeakerFeatures, SPEAKER_FEATURE_COUNT } from "./extraction/speaker";
 import {
@@ -256,12 +256,30 @@ export class PulseSession {
   async startAudio(onAudioLevel?: (rms: number) => void): Promise<void> {
     if (this.audioStageState !== "idle")
       throw new Error("Audio capture already started");
+
+    // Acquire microphone permission within the user gesture context.
+    // Awaited so the caller knows audio is ready before proceeding.
+    // State transitions happen AFTER permission succeeds to avoid zombie state.
+    const stream = await navigator.mediaDevices.getUserMedia({
+      audio: {
+        sampleRate: 16000,
+        channelCount: 1,
+        echoCancellation: false,
+        noiseSuppression: false,
+        autoGainControl: false,
+      },
+    });
+
     this.audioStageState = "capturing";
     this.audioController = new AbortController();
     this.audioPromise = captureAudio({
       signal: this.audioController.signal,
       onAudioLevel,
-    }).catch(() => null);
+      stream,
+    }).catch(() => {
+      stream.getTracks().forEach((t) => t.stop());
+      return null;
+    });
   }
 
   async stopAudio(): Promise<AudioCapture | null> {
@@ -281,10 +299,20 @@ export class PulseSession {
   async startMotion(): Promise<void> {
     if (this.motionStageState !== "idle")
       throw new Error("Motion capture already started");
+
+    // Request motion permission within the user gesture context (iOS 13+).
+    // Awaited so the capture timer doesn't start before the user approves.
+    const hasPermission = await requestMotionPermission();
+    if (!hasPermission) {
+      this.motionStageState = "skipped";
+      return;
+    }
+
     this.motionStageState = "capturing";
     this.motionController = new AbortController();
     this.motionPromise = captureMotion({
       signal: this.motionController.signal,
+      permissionGranted: true,
     }).catch(() => []);
   }
 
@@ -303,6 +331,10 @@ export class PulseSession {
     this.motionStageState = "skipped";
   }
 
+  isMotionCapturing(): boolean {
+    return this.motionStageState === "capturing";
+  }
+
   // --- Touch ---
 
   async startTouch(): Promise<void> {
@@ -412,16 +444,18 @@ export class PulseSDK {
         throw new Error(`Audio capture failed: ${err?.message ?? "microphone unavailable"}`);
       }
 
-      // Motion
+      // Motion — startMotion auto-skips if permission denied (no throw)
       try {
         await session.startMotion();
+      } catch {
+        /* unexpected error — motion already skipped or idle */
+      }
+      if (session.isMotionCapturing()) {
         stopPromises.push(
           new Promise<void>((r) => setTimeout(r, DEFAULT_CAPTURE_MS))
             .then(() => session.stopMotion())
             .then(() => {})
         );
-      } catch {
-        session.skipMotion();
       }
 
       // Touch

package/src/sensor/audio.ts

@@ -20,9 +20,10 @@ export async function captureAudio(
     minDurationMs = MIN_CAPTURE_MS,
     maxDurationMs = MAX_CAPTURE_MS,
     onAudioLevel,
+    stream: preAcquiredStream,
   } = options;
 
-  const stream = await navigator.mediaDevices.getUserMedia({
+  const stream = preAcquiredStream ?? await navigator.mediaDevices.getUserMedia({
     audio: {
       sampleRate: TARGET_SAMPLE_RATE,
       channelCount: 1,
@@ -33,6 +34,7 @@ export async function captureAudio(
   });
 
   const ctx = new AudioContext({ sampleRate: TARGET_SAMPLE_RATE });
+  await ctx.resume(); // Required on iOS — AudioContext may be suspended outside user gesture
   const capturedSampleRate = ctx.sampleRate;
   const source = ctx.createMediaStreamSource(stream);
   const chunks: Float32Array[] = [];

package/src/sensor/motion.ts

@@ -31,7 +31,7 @@ export async function captureMotion(
     maxDurationMs = MAX_CAPTURE_MS,
   } = options;
 
-  const hasPermission = await requestMotionPermission();
+  const hasPermission = options.permissionGranted ?? await requestMotionPermission();
   if (!hasPermission) return [];
 
   const samples: MotionSample[] = [];

package/src/sensor/types.ts

@@ -36,6 +36,10 @@ export interface CaptureOptions {
   maxDurationMs?: number;
   /** Called with RMS audio level (0-1) on each buffer during audio capture (~4x per second). */
   onAudioLevel?: (rms: number) => void;
+  /** Pre-acquired MediaStream. If provided, captureAudio skips getUserMedia. */
+  stream?: MediaStream;
+  /** If true, captureMotion skips requestMotionPermission (already acquired). */
+  permissionGranted?: boolean;
 }
 
 /** Stage of a capture session */