react-native-davoice-tts 1.0.356 → 1.0.358

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "react-native-davoice-tts",
-    "version": "1.0.356",
+    "version": "1.0.358",
     "description": "tts library for React Native",
     "main": "tts/index.js",
     "types": "tts/index.d.ts",

package/speech/index.ts

@@ -80,6 +80,42 @@ export type NewSpeechWAVEvent = { path: string };
 export type RNAssetLike = any; // keep permissive (Metro asset numbers/objects vary)
 export type ModelRef = string | RNAssetLike;
 
+/** iOS AVAudioSession routing entry shared by STT and TTS. */
+export type RouteConfigEntry = {
+  category: 'playAndRecord' | 'record' | 'soloAmbient' | 'ambient' | 'playback';
+  mode: 'default' | 'measurement' | 'voiceChat' | 'videoRecording' | 'gameChat';
+  options: (
+    | 'mixWithOthers'
+    | 'duckOthers'
+    | 'allowBluetooth'
+    | 'allowBluetoothA2DP'
+    | 'allowAirPlay'
+    | 'defaultToSpeaker'
+    | 'overrideMutedMicrophoneInterruption'
+  )[];
+  preferredInput: 'none' | 'builtInMic';
+  /** On onFinishPlaying, deactivate with notifyOthersOnDeactivation before restoring regular routing. */
+  notifyOthers?: boolean;
+};
+
+/** Same JSON shape accepted by react-native-wakeword. */
+export type AudioRoutingConfig = {
+  default: RouteConfigEntry;
+  byOutputPort?: {
+    carAudio?: RouteConfigEntry;
+    builtInReceiver?: RouteConfigEntry;
+    builtInSpeaker?: RouteConfigEntry;
+    bluetoothA2DP?: RouteConfigEntry;
+    bluetoothHFP?: RouteConfigEntry;
+    headphones?: RouteConfigEntry;
+  };
+  /** Optional temporary routing policy for speaker playback batches (speak/playWav/playBuffer). */
+  WhenPlayingAudio?: {
+    onPlay?: RouteConfigEntry;
+    onFinishPlaying?: RouteConfigEntry;
+  };
+};
+
 export type UnifiedEvents = {
   // STT
   onSpeechStart?: (e: SpeechStartEvent) => void;
@@ -413,6 +449,30 @@ class Speech {
 }
 
   // ---------- Init / Destroy ----------
+  /**
+   * iOS: set the routing JSON used by both STT and TTS before initialization.
+   * This direct value takes precedence over the wakeword library's config.
+   */
+  async setAudioRoutingConfig(config: AudioRoutingConfig) {
+    if (Platform.OS !== 'ios') return;
+    if (!config || typeof config !== 'object' || !config.default) {
+      throw new Error("setAudioRoutingConfig requires a config with a 'default' entry");
+    }
+    if (!NativeSpeech?.setAudioRoutingConfig) {
+      throw new Error('Native SpeechBridge missing setAudioRoutingConfig()');
+    }
+    return NativeSpeech.setAudioRoutingConfig(JSON.stringify(config));
+  }
+
+  /** Clears the direct speech config so STT/TTS fall back to wakeword routing JSON. */
+  async clearAudioRoutingConfig() {
+    if (Platform.OS !== 'ios') return;
+    if (!NativeSpeech?.clearAudioRoutingConfig) {
+      throw new Error('Native SpeechBridge missing clearAudioRoutingConfig()');
+    }
+    return NativeSpeech.clearAudioRoutingConfig();
+  }
+
   /**
    * iOS: initialize STT then TTS via native SpeechBridge if available.
    * Android: no special init needed; optionally preload TTS (if you want).