@capgo/capacitor-native-audio 8.4.15 → 8.4.17

package/ios/Sources/NativeAudioPlugin/AudioAsset+Fade.swift

@@ -3,11 +3,14 @@ import AVFoundation
 extension AudioAsset {
 
     func dispatchComplete() {
-        if dispatchedCompleteMap[assetId] == true {
-            return
+        owner?.executeOnAudioQueueAsync { [weak self] in
+            guard let self else { return }
+            if self.dispatchedCompleteMap[self.assetId] == true {
+                return
+            }
+            self.owner?.notifyListeners("complete", data: ["assetId": self.assetId])
+            self.dispatchedCompleteMap[self.assetId] = true
         }
-        owner?.notifyListeners("complete", data: ["assetId": assetId])
-        dispatchedCompleteMap[assetId] = true
     }
 
     func cancelFade() {

package/ios/Sources/NativeAudioPlugin/AudioAsset.swift

@@ -384,7 +384,10 @@ public class AudioAsset: NSObject, AVAudioPlayerDelegate {
 
     internal func startCurrentTimeUpdates() {
         stopCurrentTimeUpdates()
-        dispatchedCompleteMap[assetId] = false
+        owner?.executeOnAudioQueueAsync { [weak self] in
+            guard let self else { return }
+            self.dispatchedCompleteMap[self.assetId] = false
+        }
         DispatchQueue.main.async { [weak self] in
             guard let self else { return }
             let timer = Timer(timeInterval: 0.1, repeats: true) { [weak self] _ in

package/ios/Sources/NativeAudioPlugin/Plugin.swift

@@ -18,7 +18,7 @@ private enum PlaybackStateValue: String {
 @objc(NativeAudio)
 // swiftlint:disable:next type_body_length
 public class NativeAudio: CAPPlugin, AVAudioPlayerDelegate, CAPBridgedPlugin {
-    private let pluginVersion: String = "8.4.15"
+    private let pluginVersion: String = "8.4.17"
     public let identifier = "NativeAudio"
     public let jsName = "NativeAudio"
     public let pluginMethods: [CAPPluginMethod] = [
@@ -1565,6 +1565,17 @@ public class NativeAudio: CAPPlugin, AVAudioPlayerDelegate, CAPBridgedPlugin {
         }
     }
 
+    /// Async barrier write — serializes shared-state mutations onto the audio queue
+    /// WITHOUT blocking the calling thread. Runs inline when already on the queue
+    /// to preserve ordering.
+    internal func executeOnAudioQueueAsync(_ block: @escaping () -> Void) {
+        if DispatchQueue.getSpecific(key: queueKey) != nil {
+            block()
+        } else {
+            audioQueue.async(flags: .barrier, execute: block)
+        }
+    }
+
     /// Use this for read-only access to shared state — avoids the .barrier write lock
     /// that `executeOnAudioQueue` applies, preventing deadlocks with third-party SDKs.
     internal func readOnAudioQueue<T>(_ block: () -> T) -> T {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/capacitor-native-audio",
-  "version": "8.4.15",
+  "version": "8.4.17",
   "description": "A native plugin for native audio engine",
   "license": "MPL-2.0",
   "main": "dist/plugin.cjs.js",
@@ -59,7 +59,8 @@
     "test:e2e:android": "maestro test .maestro/android/basic-features.yaml",
     "test:e2e:ios": "maestro test .maestro/ios/basic-features.yaml",
     "prepublishOnly": "bun run build",
-    "check:wiring": "node scripts/check-capacitor-plugin-wiring.mjs"
+    "check:wiring": "node scripts/check-capacitor-plugin-wiring.mjs",
+    "changelog:ai": "node scripts/generate-ai-changelog.mjs"
   },
   "devDependencies": {
     "@capacitor/android": "^8.0.0",