react-native-kookit 0.3.7 → 0.3.9

package/README.md

@@ -8,6 +8,7 @@ A comprehensive React Native/Expo module with multiple utilities for Android and
 - 📁 **FTP Client** - Full-featured FTP client with upload/download capabilities
 - 🗂️ **SMB Client** - Access SMB/CIFS network shares
 - 📱 **Content URI Handler** (Android) - Handle `content://` URIs from other apps, bypassing permission restrictions
+- 🔊 **Audio Detection** (Android) - Detect if any audio is currently playing (music, TTS, videos, etc.)
 
 ### Content URI Handler
 
@@ -23,6 +24,36 @@ The Content URI Handler solves a common Android problem: when receiving files vi
 
 📖 [**View Content URI Handler Documentation**](./docs/CONTENT_URI_HANDLER.md)
 
+### Audio Detection
+
+The Audio Detection API allows you to check if the device is currently playing any audio, including music, TTS, videos, or any other audio source.
+
+**Key Benefits:**
+
+- ✅ Detect any audio playback (music, TTS, videos, games)
+- ✅ Simple synchronous API
+- ✅ No permissions required
+- ✅ Lightweight and fast
+- ✅ Perfect for audio queue management
+
+**Quick Example:**
+
+```typescript
+import ReactNativeKookit from "react-native-kookit";
+
+// Check if audio is playing
+const isPlaying = ReactNativeKookit.isAudioPlaying();
+console.log("Audio playing:", isPlaying);
+
+// Monitor audio state
+setInterval(() => {
+  const playing = ReactNativeKookit.isAudioPlaying();
+  console.log("Audio status:", playing ? "Playing" : "Idle");
+}, 500);
+```
+
+📖 [**View Audio Detection Documentation**](./docs/AUDIO_DETECTION.md)
+
 # API documentation
 
 - [Documentation for the latest stable release](https://docs.expo.dev/versions/latest/sdk/react-native-kookit/)

package/android/src/main/java/expo/modules/kookit/ReactNativeKookitModule.kt

@@ -928,6 +928,13 @@ class ReactNativeKookitModule : Module() {
       }
     }
 
+    // Check if audio is currently playing
+    Function("isAudioPlaying") {
+      val context = appContext.reactContext ?: return@Function false
+      val audioManager = context.getSystemService(Context.AUDIO_SERVICE) as? AudioManager
+      audioManager?.isMusicActive ?: false
+    }
+
     // Cleanup when module is destroyed
     OnDestroy {
       textToSpeech?.shutdown()

package/build/ReactNativeKookitModule.d.ts

@@ -177,6 +177,14 @@ declare class ReactNativeKookitModule extends NativeModule<ReactNativeKookitModu
      * @returns Promise that resolves with file path and duration of the generated audio
      */
     synthesizeSpeech(options: TtsSynthesizeOptions): Promise<TtsSynthesizeResult>;
+    /**
+     * Check if the device is currently playing any audio (music, TTS, or other audio).
+     * Uses AudioManager.isMusicActive() on Android which detects any audio playback.
+     *
+     * @returns Boolean indicating whether audio is currently playing
+     * @platform android
+     */
+    isAudioPlaying(): boolean;
 }
 declare const _default: ReactNativeKookitModule;
 export default _default;

package/build/ReactNativeKookitModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReactNativeKookitModule.d.ts","sourceRoot":"","sources":["../src/ReactNativeKookitModule.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ReactNativeKookitModule.d.ts","sourceRoot":"","sources":["../src/ReactNativeKookitModule.ts"],"names":[],"mappings":"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"}

package/build/ReactNativeKookitModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReactNativeKookitModule.js","sourceRoot":"","sources":["../src/ReactNativeKookitModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AA+OzD,yDAAyD;AACzD,eAAe,mBAAmB,CAChC,mBAAmB,CACpB,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\";\n\nimport {\n  ReactNativeKookitModuleEvents,\n  FtpConnectionConfig,\n  FtpFileInfo,\n  SmbConnectionConfig,\n  SmbFileInfo,\n  TtsSynthesizeOptions,\n  TtsSynthesizeResult,\n} from \"./ReactNativeKookit.types\";\n\ndeclare class ReactNativeKookitModule extends NativeModule<ReactNativeKookitModuleEvents> {\n  PI: number;\n\n  /**\n   * Returns a hello world string\n   */\n  hello(): string;\n\n  /**\n   * Test async function that sends a change event\n   */\n  setValueAsync(value: string): Promise<void>;\n\n  /**\n   * Enables volume key interception.\n   * On Android, your MainActivity must implement VolumeKeyInterceptActivity interface.\n   * On iOS, this works automatically.\n   *\n   * @throws Error if MainActivity doesn't implement VolumeKeyInterceptActivity on Android\n   */\n  enableVolumeKeyInterception(): void;\n\n  /**\n   * Disables volume key interception\n   */\n  disableVolumeKeyInterception(): void;\n\n  // New FTP Client API Methods\n\n  /**\n   * Create a new FTP client instance\n   * @param clientId Unique identifier for the FTP client\n   * @returns Promise that resolves with client creation result\n   */\n  createFtpClient(clientId: string): Promise<{ clientId: string }>;\n\n  /**\n   * Connect FTP client to server\n   * @param clientId FTP client identifier\n   * @param config FTP connection configuration\n   * @returns Promise that resolves when connected\n   */\n  ftpClientConnect(\n    clientId: string,\n    config: FtpConnectionConfig\n  ): Promise<void>;\n\n  /**\n   * Disconnect FTP client from server\n   * @param clientId FTP client identifier\n   * @returns Promise that resolves when disconnected\n   */\n  ftpClientDisconnect(clientId: string): Promise<void>;\n\n  /**\n   * Dispose FTP client and clean up resources\n   * @param clientId FTP client identifier\n   * @returns Promise that resolves when disposed\n   */\n  disposeFtpClient(clientId: string): Promise<void>;\n\n  /**\n   * List files and directories\n   * @param clientId FTP client identifier\n   * @param path Optional path to list (defaults to current directory)\n   * @returns Promise that resolves with array of file information\n   */\n  ftpClientList(clientId: string, path?: string): Promise<FtpFileInfo[]>;\n\n  /**\n   * Download a file from FTP server\n   * @param clientId FTP client identifier\n   * @param remotePath Remote file path on FTP server\n   * @param localPath Local file path to save the downloaded file\n   * @returns Promise that resolves when download is complete\n   */\n  ftpClientDownload(\n    clientId: string,\n    remotePath: string,\n    localPath: string\n  ): Promise<void>;\n\n  /**\n   * Upload a file to FTP server\n   * @param clientId FTP client identifier\n   * @param localPath Local file path to upload\n   * @param remotePath Remote file path on FTP server\n   * @returns Promise that resolves when upload is complete\n   */\n  ftpClientUpload(\n    clientId: string,\n    localPath: string,\n    remotePath: string\n  ): Promise<void>;\n\n  /**\n   * Delete a file or directory on FTP server\n   * @param clientId FTP client identifier\n   * @param remotePath Remote file or directory path to delete\n   * @param isDirectory Whether the path is a directory (default: false)\n   * @returns Promise that resolves when deletion is complete\n   */\n  ftpClientDelete(\n    clientId: string,\n    remotePath: string,\n    isDirectory?: boolean\n  ): Promise<void>;\n\n  /**\n   * Create a directory on FTP server\n   * @param clientId FTP client identifier\n   * @param remotePath Remote directory path to create\n   * @returns Promise that resolves when directory is created\n   */\n  ftpClientCreateDirectory(clientId: string, remotePath: string): Promise<void>;\n\n  /**\n   * Change current working directory on FTP server\n   * @param clientId FTP client identifier\n   * @param remotePath Remote directory path to change to\n   * @returns Promise that resolves when directory is changed\n   */\n  ftpClientChangeDirectory(clientId: string, remotePath: string): Promise<void>;\n\n  /**\n   * Get current working directory on FTP server\n   * @param clientId FTP client identifier\n   * @returns Promise that resolves with current directory path\n   */\n  ftpClientGetCurrentDirectory(clientId: string): Promise<string>;\n\n  /**\n   * Get FTP client status\n   * @param clientId FTP client identifier\n   * @returns Client status information\n   */\n  getFtpClientStatus(\n    clientId: string\n  ): Promise<{ exists: boolean; connected: boolean }>;\n\n  /**\n   * List all FTP clients\n   * @returns Object containing all clients and their status\n   */\n  listFtpClients(): Promise<{\n    clients: Record<string, { connected: boolean }>;\n    count: number;\n  }>;\n\n  // SMB Client API\n\n  createSmbClient(clientId: string): Promise<{ clientId: string }>;\n  smbClientConnect(\n    clientId: string,\n    config: SmbConnectionConfig\n  ): Promise<void>;\n  smbClientConnectShare(clientId: string, shareName: string): Promise<void>;\n  smbClientDisconnect(clientId: string): Promise<void>;\n  disposeSmbClient(clientId: string): Promise<void>;\n  smbClientList(clientId: string, path?: string): Promise<SmbFileInfo[]>;\n  smbClientDownload(\n    clientId: string,\n    remotePath: string,\n    localPath: string\n  ): Promise<void>;\n  smbClientUpload(\n    clientId: string,\n    localPath: string,\n    remotePath: string\n  ): Promise<void>;\n  smbClientDelete(\n    clientId: string,\n    remotePath: string,\n    isDirectory?: boolean\n  ): Promise<void>;\n  smbClientCreateDirectory(clientId: string, remotePath: string): Promise<void>;\n  getSmbClientStatus(\n    clientId: string\n  ): Promise<{ exists: boolean; connected: boolean }>;\n  listSmbClients(): Promise<{\n    clients: Record<string, { connected: boolean }>;\n    count: number;\n  }>;\n\n  /**\n   * Copy a file from content:// URI to local cache directory.\n   * This method uses Android's ContentResolver to read the file stream,\n   * bypassing permission restrictions when receiving content URIs from other apps.\n   *\n   * @param contentUri The content:// URI received from another app (e.g., via Intent)\n   * @param fileName Optional filename for the destination file. If not provided, tries to extract from URI\n   * @returns Promise that resolves with the local file path (file://)\n   * @platform android\n   */\n  copyContentUriToCache(\n    contentUri: string,\n    fileName?: string\n  ): Promise<{\n    localPath: string;\n    fileName: string;\n    mimeType?: string;\n    size?: number;\n  }>;\n\n  /**\n   * Get metadata about a content:// URI without copying the file.\n   *\n   * @param contentUri The content:// URI to query\n   * @returns Promise that resolves with file metadata\n   * @platform android\n   */\n  getContentUriMetadata(contentUri: string): Promise<{\n    displayName?: string;\n    mimeType?: string;\n    size?: number;\n  }>;\n\n  /**\n   * Synthesize speech from text and save to audio file.\n   * The audio file will be saved in the cache directory under 'tts' folder.\n   *\n   * @param options TTS synthesis options including text, voiceId, language, pitch, and rate\n   * @returns Promise that resolves with file path and duration of the generated audio\n   */\n  synthesizeSpeech(options: TtsSynthesizeOptions): Promise<TtsSynthesizeResult>;\n}\n\n// This call loads the native module object from the JSI.\nexport default requireNativeModule<ReactNativeKookitModule>(\n  \"ReactNativeKookit\"\n);\n"]}
+{"version":3,"file":"ReactNativeKookitModule.js","sourceRoot":"","sources":["../src/ReactNativeKookitModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAwPzD,yDAAyD;AACzD,eAAe,mBAAmB,CAChC,mBAAmB,CACpB,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\";\n\nimport {\n  ReactNativeKookitModuleEvents,\n  FtpConnectionConfig,\n  FtpFileInfo,\n  SmbConnectionConfig,\n  SmbFileInfo,\n  TtsSynthesizeOptions,\n  TtsSynthesizeResult,\n} from \"./ReactNativeKookit.types\";\n\ndeclare class ReactNativeKookitModule extends NativeModule<ReactNativeKookitModuleEvents> {\n  PI: number;\n\n  /**\n   * Returns a hello world string\n   */\n  hello(): string;\n\n  /**\n   * Test async function that sends a change event\n   */\n  setValueAsync(value: string): Promise<void>;\n\n  /**\n   * Enables volume key interception.\n   * On Android, your MainActivity must implement VolumeKeyInterceptActivity interface.\n   * On iOS, this works automatically.\n   *\n   * @throws Error if MainActivity doesn't implement VolumeKeyInterceptActivity on Android\n   */\n  enableVolumeKeyInterception(): void;\n\n  /**\n   * Disables volume key interception\n   */\n  disableVolumeKeyInterception(): void;\n\n  // New FTP Client API Methods\n\n  /**\n   * Create a new FTP client instance\n   * @param clientId Unique identifier for the FTP client\n   * @returns Promise that resolves with client creation result\n   */\n  createFtpClient(clientId: string): Promise<{ clientId: string }>;\n\n  /**\n   * Connect FTP client to server\n   * @param clientId FTP client identifier\n   * @param config FTP connection configuration\n   * @returns Promise that resolves when connected\n   */\n  ftpClientConnect(\n    clientId: string,\n    config: FtpConnectionConfig\n  ): Promise<void>;\n\n  /**\n   * Disconnect FTP client from server\n   * @param clientId FTP client identifier\n   * @returns Promise that resolves when disconnected\n   */\n  ftpClientDisconnect(clientId: string): Promise<void>;\n\n  /**\n   * Dispose FTP client and clean up resources\n   * @param clientId FTP client identifier\n   * @returns Promise that resolves when disposed\n   */\n  disposeFtpClient(clientId: string): Promise<void>;\n\n  /**\n   * List files and directories\n   * @param clientId FTP client identifier\n   * @param path Optional path to list (defaults to current directory)\n   * @returns Promise that resolves with array of file information\n   */\n  ftpClientList(clientId: string, path?: string): Promise<FtpFileInfo[]>;\n\n  /**\n   * Download a file from FTP server\n   * @param clientId FTP client identifier\n   * @param remotePath Remote file path on FTP server\n   * @param localPath Local file path to save the downloaded file\n   * @returns Promise that resolves when download is complete\n   */\n  ftpClientDownload(\n    clientId: string,\n    remotePath: string,\n    localPath: string\n  ): Promise<void>;\n\n  /**\n   * Upload a file to FTP server\n   * @param clientId FTP client identifier\n   * @param localPath Local file path to upload\n   * @param remotePath Remote file path on FTP server\n   * @returns Promise that resolves when upload is complete\n   */\n  ftpClientUpload(\n    clientId: string,\n    localPath: string,\n    remotePath: string\n  ): Promise<void>;\n\n  /**\n   * Delete a file or directory on FTP server\n   * @param clientId FTP client identifier\n   * @param remotePath Remote file or directory path to delete\n   * @param isDirectory Whether the path is a directory (default: false)\n   * @returns Promise that resolves when deletion is complete\n   */\n  ftpClientDelete(\n    clientId: string,\n    remotePath: string,\n    isDirectory?: boolean\n  ): Promise<void>;\n\n  /**\n   * Create a directory on FTP server\n   * @param clientId FTP client identifier\n   * @param remotePath Remote directory path to create\n   * @returns Promise that resolves when directory is created\n   */\n  ftpClientCreateDirectory(clientId: string, remotePath: string): Promise<void>;\n\n  /**\n   * Change current working directory on FTP server\n   * @param clientId FTP client identifier\n   * @param remotePath Remote directory path to change to\n   * @returns Promise that resolves when directory is changed\n   */\n  ftpClientChangeDirectory(clientId: string, remotePath: string): Promise<void>;\n\n  /**\n   * Get current working directory on FTP server\n   * @param clientId FTP client identifier\n   * @returns Promise that resolves with current directory path\n   */\n  ftpClientGetCurrentDirectory(clientId: string): Promise<string>;\n\n  /**\n   * Get FTP client status\n   * @param clientId FTP client identifier\n   * @returns Client status information\n   */\n  getFtpClientStatus(\n    clientId: string\n  ): Promise<{ exists: boolean; connected: boolean }>;\n\n  /**\n   * List all FTP clients\n   * @returns Object containing all clients and their status\n   */\n  listFtpClients(): Promise<{\n    clients: Record<string, { connected: boolean }>;\n    count: number;\n  }>;\n\n  // SMB Client API\n\n  createSmbClient(clientId: string): Promise<{ clientId: string }>;\n  smbClientConnect(\n    clientId: string,\n    config: SmbConnectionConfig\n  ): Promise<void>;\n  smbClientConnectShare(clientId: string, shareName: string): Promise<void>;\n  smbClientDisconnect(clientId: string): Promise<void>;\n  disposeSmbClient(clientId: string): Promise<void>;\n  smbClientList(clientId: string, path?: string): Promise<SmbFileInfo[]>;\n  smbClientDownload(\n    clientId: string,\n    remotePath: string,\n    localPath: string\n  ): Promise<void>;\n  smbClientUpload(\n    clientId: string,\n    localPath: string,\n    remotePath: string\n  ): Promise<void>;\n  smbClientDelete(\n    clientId: string,\n    remotePath: string,\n    isDirectory?: boolean\n  ): Promise<void>;\n  smbClientCreateDirectory(clientId: string, remotePath: string): Promise<void>;\n  getSmbClientStatus(\n    clientId: string\n  ): Promise<{ exists: boolean; connected: boolean }>;\n  listSmbClients(): Promise<{\n    clients: Record<string, { connected: boolean }>;\n    count: number;\n  }>;\n\n  /**\n   * Copy a file from content:// URI to local cache directory.\n   * This method uses Android's ContentResolver to read the file stream,\n   * bypassing permission restrictions when receiving content URIs from other apps.\n   *\n   * @param contentUri The content:// URI received from another app (e.g., via Intent)\n   * @param fileName Optional filename for the destination file. If not provided, tries to extract from URI\n   * @returns Promise that resolves with the local file path (file://)\n   * @platform android\n   */\n  copyContentUriToCache(\n    contentUri: string,\n    fileName?: string\n  ): Promise<{\n    localPath: string;\n    fileName: string;\n    mimeType?: string;\n    size?: number;\n  }>;\n\n  /**\n   * Get metadata about a content:// URI without copying the file.\n   *\n   * @param contentUri The content:// URI to query\n   * @returns Promise that resolves with file metadata\n   * @platform android\n   */\n  getContentUriMetadata(contentUri: string): Promise<{\n    displayName?: string;\n    mimeType?: string;\n    size?: number;\n  }>;\n\n  /**\n   * Synthesize speech from text and save to audio file.\n   * The audio file will be saved in the cache directory under 'tts' folder.\n   *\n   * @param options TTS synthesis options including text, voiceId, language, pitch, and rate\n   * @returns Promise that resolves with file path and duration of the generated audio\n   */\n  synthesizeSpeech(options: TtsSynthesizeOptions): Promise<TtsSynthesizeResult>;\n\n  /**\n   * Check if the device is currently playing any audio (music, TTS, or other audio).\n   * Uses AudioManager.isMusicActive() on Android which detects any audio playback.\n   *\n   * @returns Boolean indicating whether audio is currently playing\n   * @platform android\n   */\n  isAudioPlaying(): boolean;\n}\n\n// This call loads the native module object from the JSI.\nexport default requireNativeModule<ReactNativeKookitModule>(\n  \"ReactNativeKookit\"\n);\n"]}

package/ios/ReactNativeKookitModule.swift

@@ -1551,25 +1551,41 @@ public class ReactNativeKookitModule: Module {
 
     // TTS (Text-to-Speech) Function
     AsyncFunction("synthesizeSpeech") { (options: [String: Any], promise: Promise) in
-      Task {
-        do {
-          let text = options["text"] as? String ?? ""
-          if text.isEmpty {
-            promise.reject("TTS_ERROR", "Text is required")
-            return
-          }
-          
-          let voiceId = options["voiceId"] as? String
-          let language = options["language"] as? String ?? "en-US"
-          let pitch = options["pitch"] as? Double ?? 1.0
-          let rate = options["rate"] as? Double ?? 1.0
-          
-          // Initialize synthesizer if needed
+      // Extract parameters
+      let text = options["text"] as? String ?? ""
+      if text.isEmpty {
+        promise.reject("TTS_ERROR", "Text is required")
+        return
+      }
+      
+      let voiceId = options["voiceId"] as? String
+      let language = options["language"] as? String ?? "en-US"
+      let pitch = options["pitch"] as? Double ?? 1.0
+      let rate = options["rate"] as? Double ?? 1.0
+      //print the voiceId
+      print("voiceId: \(voiceId)")
+      //print the language
+      print("language: \(language)")
+      //print the pitch
+      print("pitch: \(pitch)")
+      //print the rate
+      print("rate: \(rate)")
+      
+      // Initialize synthesizer on main thread if needed
+      if self.speechSynthesizer == nil {
+        DispatchQueue.main.sync {
           if self.speechSynthesizer == nil {
-            self.speechSynthesizer = AVSpeechSynthesizer()
+            let synth = AVSpeechSynthesizer()
+            synth.usesApplicationAudioSession = true
+            self.speechSynthesizer = synth
           }
-          
-          let filePath = try await self.synthesizeSpeechToFile(
+        }
+      }
+      
+      // Perform synthesis on a background queue to avoid blocking
+      DispatchQueue.global(qos: .userInitiated).async {
+        do {
+          let filePath = try self.synthesizeSpeechToFileSync(
             text: text,
             voiceId: voiceId,
             language: language,
@@ -1686,78 +1702,126 @@ public class ReactNativeKookitModule: Module {
   
   // MARK: - TTS Helper Methods
   
-  private func synthesizeSpeechToFile(text: String, voiceId: String?, language: String, pitch: Float, rate: Float) async throws -> String {
-    return try await withCheckedThrowingContinuation { continuation in
-      guard let synthesizer = self.speechSynthesizer else {
-        continuation.resume(throwing: NSError(domain: "TTS", code: -1, userInfo: [NSLocalizedDescriptionKey: "Speech synthesizer not initialized"]))
-        return
-      }
-      
-      let utterance = AVSpeechUtterance(string: text)
-      
-      // Set voice
-      if let voiceId = voiceId {
-        utterance.voice = AVSpeechSynthesisVoice(identifier: voiceId)
+  // Synchronous version using write callback to generate audio file WITHOUT playing
+  private func synthesizeSpeechToFileSync(text: String, voiceId: String?, language: String, pitch: Float, rate: Float) throws -> String {
+    guard let synthesizer = self.speechSynthesizer else {
+      throw NSError(domain: "TTS", code: -1, userInfo: [NSLocalizedDescriptionKey: "Speech synthesizer not initialized"])
+    }
+    
+    // Create utterance
+    let utterance = AVSpeechUtterance(string: text)
+    
+    // Set voice
+    if let voiceId = voiceId {
+      utterance.voice = AVSpeechSynthesisVoice(identifier: voiceId)
+    } else {
+      let voices = AVSpeechSynthesisVoice.speechVoices()
+      if let voice = voices.first(where: { $0.language.hasPrefix(language) }) {
+        utterance.voice = voice
       } else {
-        // Try to find voice by language
-        let voices = AVSpeechSynthesisVoice.speechVoices()
-        if let voice = voices.first(where: { $0.language.hasPrefix(language) }) {
-          utterance.voice = voice
-        } else {
-          utterance.voice = AVSpeechSynthesisVoice(language: language)
-        }
+        utterance.voice = AVSpeechSynthesisVoice(language: language)
+      }
+    }
+    
+    // Set pitch and rate
+    utterance.pitchMultiplier = max(0.5, min(pitch, 2.0))
+    let minRate = AVSpeechUtteranceMinimumSpeechRate
+    let maxRate = AVSpeechUtteranceMaximumSpeechRate
+    let targetRate = rate * AVSpeechUtteranceDefaultSpeechRate
+    utterance.rate = min(max(targetRate, minRate), maxRate)
+    
+    // Create TTS cache directory
+    let cacheDir = FileManager.default.urls(for: .cachesDirectory, in: .userDomainMask)[0]
+    let ttsDir = cacheDir.appendingPathComponent("tts")
+    try FileManager.default.createDirectory(at: ttsDir, withIntermediateDirectories: true, attributes: nil)
+    
+    // Generate unique filename
+    let fileName = "tts_\(UUID().uuidString).caf"
+    let outputURL = ttsDir.appendingPathComponent(fileName)
+    
+    // Synchronization
+    let semaphore = DispatchSemaphore(value: 0)
+    var audioFile: AVAudioFile?
+    var capturedError: Error?
+    var bufferCount = 0
+    
+    print("🎤 Starting TTS audio generation (without playback)...")
+    
+    // Use write callback to generate audio WITHOUT playing
+    synthesizer.write(utterance) { buffer in
+      // Check for completion: buffer with frameLength == 0 OR buffer is nil
+      guard let pcmBuffer = buffer as? AVAudioPCMBuffer else {
+        // buffer is nil or not PCM - this means completion
+        print("✅ TTS generation completed, total buffers: \(bufferCount)")
+        semaphore.signal()
+        return
       }
       
-      // Set pitch and rate
-      utterance.pitchMultiplier = pitch
-      utterance.rate = rate * AVSpeechUtteranceDefaultSpeechRate
-      
-      // Create TTS cache directory
-      let cacheDir = FileManager.default.urls(for: .cachesDirectory, in: .userDomainMask)[0]
-      let ttsDir = cacheDir.appendingPathComponent("tts")
-      
-      do {
-        try FileManager.default.createDirectory(at: ttsDir, withIntermediateDirectories: true, attributes: nil)
-      } catch {
-        continuation.resume(throwing: error)
+      // Check if this is an empty buffer (completion signal)
+      if pcmBuffer.frameLength == 0 {
+        print("✅ TTS generation completed (empty buffer), total buffers: \(bufferCount)")
+        semaphore.signal()
         return
       }
       
-      // Generate unique filename
-      let fileName = "tts_\(UUID().uuidString).caf"
-      let outputURL = ttsDir.appendingPathComponent(fileName)
+      // Process non-empty buffer
+      bufferCount += 1
       
-      // Write utterance to file using AVSpeechSynthesizer.write
-      Task {
-        do {
-          var audioBuffers: [AVAudioPCMBuffer] = []
-          
-          synthesizer.write(utterance) { buffer in
-            if let buffer = buffer as? AVAudioPCMBuffer {
-              audioBuffers.append(buffer)
-            } else if buffer == nil {
-              // Writing is complete when buffer is nil
-              Task {
-                do {
-                  // Write all buffers to file
-                  try self.writeBuffersToFile(buffers: audioBuffers, url: outputURL)
-                  continuation.resume(returning: outputURL.path)
-                } catch {
-                  continuation.resume(throwing: error)
-                }
-              }
-            }
-          }
+      do {
+        // Create audio file on first buffer
+        if audioFile == nil {
+          print("📝 Creating audio file with format: \(pcmBuffer.format)")
+          audioFile = try AVAudioFile(
+            forWriting: outputURL,
+            settings: pcmBuffer.format.settings
+          )
+        }
+        
+        // Write buffer to file
+        try audioFile?.write(from: pcmBuffer)
+        
+        if bufferCount % 10 == 0 {
+          print("📦 Written \(bufferCount) buffers...")
         }
+      } catch {
+        print("❌ Error writing buffer: \(error)")
+        capturedError = error
+        semaphore.signal()
       }
     }
+    
+    // Wait for completion
+    print("⏳ Waiting for audio generation to complete...")
+    semaphore.wait()
+    
+    // Check for errors
+    if let error = capturedError {
+      throw error
+    }
+    
+    // Verify audio file was created
+    guard audioFile != nil else {
+      throw NSError(domain: "TTS", code: -1, userInfo: [NSLocalizedDescriptionKey: "No audio data was generated"])
+    }
+    
+    print("✅ Audio file created: \(outputURL.path)")
+    return outputURL.path
   }
   
   private func writeBuffersToFile(buffers: [AVAudioPCMBuffer], url: URL) throws {
+    guard !buffers.isEmpty else {
+      throw NSError(domain: "TTS", code: -1, userInfo: [NSLocalizedDescriptionKey: "No audio data generated"])
+    }
+    
     guard let firstBuffer = buffers.first else {
       throw NSError(domain: "TTS", code: -1, userInfo: [NSLocalizedDescriptionKey: "No audio data generated"])
     }
     
+    // Verify that the buffer has valid data
+    guard firstBuffer.frameLength > 0 else {
+      throw NSError(domain: "TTS", code: -1, userInfo: [NSLocalizedDescriptionKey: "Audio buffer is empty (frameLength is 0)"])
+    }
+    
     // Create audio file with settings from the buffer
     let settings: [String: Any] = [
       AVFormatIDKey: kAudioFormatLinearPCM,
@@ -1772,7 +1836,10 @@ public class ReactNativeKookitModule: Module {
     
     // Write all buffers to file
     for buffer in buffers {
-      try audioFile.write(from: buffer)
+      // Skip empty buffers
+      if buffer.frameLength > 0 {
+        try audioFile.write(from: buffer)
+      }
     }
   }
   

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-kookit",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "React Native module for intercepting volume button presses on iOS and Android, with FTP client functionality",
   "main": "build/index.js",
   "types": "build/index.d.ts",