feature/microphone-permission

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 The changelog for `SuperwallKit`. Also see the [releases](https://github.com/superwall/Superwall-iOS/releases) on GitHub.
 
+## 4.12.5
+
+### Enhancements
+
+- Adds microphone permission request support.
+
 ## 4.12.4
 
 ### Enhancements

CLAUDE.md

@@ -66,8 +66,11 @@ SuperwallKit is an iOS SDK for remote paywall configuration and A/B testing. The
 
 ### Version Management
 
-- Version is defined in `Sources/SuperwallKit/Misc/Constants.swift` line 21
-- Pre-commit hook automatically syncs version to `SuperwallKit.podspec`
+When bumping the version, update all three files:
+1. `Sources/SuperwallKit/Misc/Constants.swift` (line 21)
+2. `SuperwallKit.podspec` (s.version)
+3. `CHANGELOG.md` (add new version entry at top)
+
 - Follows semantic versioning
 
 ### Testing

Sources/SuperwallKit/Misc/Constants.swift

@@ -18,5 +18,5 @@ let sdkVersion = """
 */
 
 let sdkVersion = """
-4.12.4
+4.12.5
 """

Sources/SuperwallKit/Permissions/AuthorizationStatus+PermissionStatus.swift

@@ -55,6 +55,20 @@ extension AVAuthorizationStatus {
   }
 }
 
+extension AVAudioSession.RecordPermission {
+  var toPermissionStatus: PermissionStatus {
+    switch self {
+    case .granted:
+      return .granted
+    case .denied,
+      .undetermined:
+      return .denied
+    @unknown default:
+      return .unsupported
+    }
+  }
+}
+
 extension Int {
   var toContactsPermissionStatus: PermissionStatus {
     // CNAuthorizationStatus:

Sources/SuperwallKit/Permissions/Handlers/PermissionHandler+Microphone.swift

@@ -0,0 +1,36 @@
+//
+//  PermissionHandler+Microphone.swift
+//  SuperwallKit
+//
+//  Created by Yusuf Tör on 13/01/2026.
+//
+
+import AVFoundation
+
+extension PermissionHandler {
+  func checkMicrophonePermission() -> PermissionStatus {
+    return AVAudioSession.sharedInstance().recordPermission.toPermissionStatus
+  }
+
+  @MainActor
+  func requestMicrophonePermission() async -> PermissionStatus {
+    guard hasPlistKey(PlistKey.microphone) else {
+      await showMissingPlistKeyAlert(
+        for: PlistKey.microphone,
+        permissionName: "Microphone"
+      )
+      return .unsupported
+    }
+
+    let currentStatus = checkMicrophonePermission()
+    if currentStatus == .granted {
+      return .granted
+    }
+
+    return await withCheckedContinuation { continuation in
+      AVAudioSession.sharedInstance().requestRecordPermission { granted in
+        continuation.resume(returning: granted ? .granted : .denied)
+      }
+    }
+  }
+}

Sources/SuperwallKit/Permissions/PermissionHandler.swift

@@ -21,6 +21,7 @@ final class PermissionHandler: PermissionHandling {
     static let locationWhenInUse = "NSLocationWhenInUseUsageDescription"
     static let locationAlways = "NSLocationAlwaysAndWhenInUseUsageDescription"
     static let tracking = "NSUserTrackingUsageDescription"
+    static let microphone = "NSMicrophoneUsageDescription"
   }
 
   func hasPlistKey(_ key: String) -> Bool {
@@ -69,6 +70,8 @@ final class PermissionHandler: PermissionHandling {
       return checkCameraPermission()
     case .tracking:
       return checkTrackingPermission()
+    case .microphone:
+      return checkMicrophonePermission()
     }
   }
 
@@ -88,6 +91,8 @@ final class PermissionHandler: PermissionHandling {
       return await requestCameraPermission()
     case .tracking:
       return await requestTrackingPermission()
+    case .microphone:
+      return await requestMicrophonePermission()
     }
   }
 }

Sources/SuperwallKit/Permissions/PermissionType.swift

@@ -17,4 +17,5 @@ enum PermissionType: String, Decodable {
   case contacts
   case camera
   case tracking
+  case microphone
 }

SuperwallKit.podspec

@@ -1,7 +1,7 @@
 Pod::Spec.new do |s|
 
 	s.name         = "SuperwallKit"
-  s.version      = "4.12.4"
+  s.version      = "4.12.5"
 	s.summary      = "Superwall: In-App Paywalls Made Easy"
 	s.description  = "Paywall infrastructure for mobile apps :) we make things like editing your paywall and running price tests as easy as clicking a few buttons. superwall.com"
 

Tests/SuperwallKitTests/Permissions/MicrophonePermissionTests.swift

@@ -0,0 +1,47 @@
+//
+//  MicrophonePermissionTests.swift
+//  SuperwallKitTests
+//
+//  Created by Yusuf Tör on 13/01/2026.
+//
+
+import AVFoundation
+import Foundation
+import Testing
+@testable import SuperwallKit
+
+@Suite
+struct MicrophonePermissionConversionTests {
+  @Test func toPermissionStatus_granted_returnsGranted() {
+    let status = AVAudioSession.RecordPermission.granted
+    #expect(status.toPermissionStatus == .granted)
+  }
+
+  @Test func toPermissionStatus_denied_returnsDenied() {
+    let status = AVAudioSession.RecordPermission.denied
+    #expect(status.toPermissionStatus == .denied)
+  }
+
+  @Test func toPermissionStatus_undetermined_returnsDenied() {
+    let status = AVAudioSession.RecordPermission.undetermined
+    #expect(status.toPermissionStatus == .denied)
+  }
+}
+
+@Suite
+struct PermissionTypeMicrophoneTests {
+  @Test func microphoneCase_exists() {
+    let permission = PermissionType.microphone
+    #expect(permission.rawValue == "microphone")
+  }
+
+  @Test func microphone_isDecodable() throws {
+    let json = """
+    "microphone"
+    """.data(using: .utf8)!
+
+    let decoder = JSONDecoder()
+    let result = try decoder.decode(PermissionType.self, from: json)
+    #expect(result == .microphone)
+  }
+}