@capgo/capacitor-audio-session 7.0.2

package/CapgoCapacitorPluginAudioSession.podspec

@@ -0,0 +1,18 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'CapgoCapacitorPluginAudioSession'
+  s.version = package['version']
+  s.summary = package['description']
+  s.license = package['license']
+  s.homepage = package['repository']['url']
+  s.author = package['author']
+  s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
+  s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.exclude_files = '**/node_modules/**/*', '**/examples/**/*'
+  s.ios.deployment_target = '14.0'
+  s.dependency 'Capacitor'
+  s.swift_version = '5.1'
+end

package/Package.swift

@@ -0,0 +1,28 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "CapgoCapacitorPluginAudioSession",
+    platforms: [.iOS(.v14)],
+    products: [
+        .library(
+            name: "CapgoCapacitorPluginAudioSession",
+            targets: ["AudioSessionPlugin"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "7.4.2")
+    ],
+    targets: [
+        .target(
+            name: "AudioSessionPlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm")
+            ],
+            path: "ios/Sources/AudioSessionPlugin"),
+        .testTarget(
+            name: "AudioSessionPluginTests",
+            dependencies: ["AudioSessionPlugin"],
+            path: "ios/Tests/AudioSessionPluginTests")
+    ]
+)

package/README.md

@@ -0,0 +1,201 @@
+# @capgo/capacitor-plugin-audiosession
+ <a href="https://capgo.app/"><img src='https://raw.githubusercontent.com/Cap-go/capgo/main/assets/capgo_banner.png' alt='Capgo - Instant updates for capacitor'/></a>
+
+<div align="center">
+  <h2><a href="https://capgo.app/?ref=plugin"> ➡️ Get Instant updates for your App with Capgo</a></h2>
+  <h2><a href="https://capgo.app/consulting/?ref=plugin"> Missing a feature? We’ll build the plugin for you 💪</a></h2>
+</div>
+
+
+**This plugin works on iOS only.**
+
+This plugin is a port of <https://github.com/saghul/cordova-plugin-audioroute> and allows iOS applications to get notified about audio session interruptions and route changes (for example when a headset is connected). To query and override the audio device in use is also supported.
+
+## Install
+
+```bash
+npm install @capgo/capacitor-plugin-audiosession
+npx cap sync
+```
+
+For now this plugin works only in Capacitor 4.0+.
+
+## API
+
+<docgen-index>
+
+* [`currentOutputs()`](#currentoutputs)
+* [`overrideOutput(...)`](#overrideoutput)
+* [`addListener('routeChanged', ...)`](#addlistenerroutechanged-)
+* [`addListener('interruption', ...)`](#addlistenerinterruption-)
+* [Interfaces](#interfaces)
+* [Type Aliases](#type-aliases)
+* [Enums](#enums)
+
+</docgen-index>
+
+<docgen-api>
+<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
+
+iOS-only plugin to query and control the audio session output and listen to
+route changes and interruptions.
+
+### currentOutputs()
+
+```typescript
+currentOutputs() => Promise<AudioSessionPorts[]>
+```
+
+Get the current active audio output routes.
+
+On web and non-iOS platforms, this resolves to an empty array.
+
+**Returns:** <code>Promise&lt;AudioSessionPorts[]&gt;</code>
+
+--------------------
+
+
+### overrideOutput(...)
+
+```typescript
+overrideOutput(type: OutputOverrideType) => Promise<OverrideResult>
+```
+
+Override the current audio output route.
+
+Use `speaker` to force playback through the built-in speaker, or
+`default` to restore the system-selected route.
+
+| Param      | Type                                                              | Description                       |
+| ---------- | ----------------------------------------------------------------- | --------------------------------- |
+| **`type`** | <code><a href="#outputoverridetype">OutputOverrideType</a></code> | The desired output override type. |
+
+**Returns:** <code>Promise&lt;<a href="#overrideresult">OverrideResult</a>&gt;</code>
+
+--------------------
+
+
+### addListener('routeChanged', ...)
+
+```typescript
+addListener(eventName: 'routeChanged', listenerFunc: RouteChangeListener) => Promise<PluginListenerHandle>
+```
+
+Listen for audio route changes (e.g. headset connected/disconnected).
+
+| Param              | Type                                                                | Description                                    |
+| ------------------ | ------------------------------------------------------------------- | ---------------------------------------------- |
+| **`eventName`**    | <code>'routeChanged'</code>                                         | The route change event name.                   |
+| **`listenerFunc`** | <code><a href="#routechangelistener">RouteChangeListener</a></code> | Callback invoked with the route change reason. |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### addListener('interruption', ...)
+
+```typescript
+addListener(eventName: 'interruption', listenerFunc: InterruptionListener) => Promise<PluginListenerHandle>
+```
+
+Listen for audio session interruptions (e.g. incoming call) and their end.
+
+| Param              | Type                                                                  | Description                                  |
+| ------------------ | --------------------------------------------------------------------- | -------------------------------------------- |
+| **`eventName`**    | <code>'interruption'</code>                                           | The interruption event name.                 |
+| **`listenerFunc`** | <code><a href="#interruptionlistener">InterruptionListener</a></code> | Callback invoked with the interruption type. |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### Interfaces
+
+
+#### PluginListenerHandle
+
+| Prop         | Type                                      |
+| ------------ | ----------------------------------------- |
+| **`remove`** | <code>() =&gt; Promise&lt;void&gt;</code> |
+
+
+### Type Aliases
+
+
+#### OverrideResult
+
+Result of an output override request.
+
+<code>{ success: boolean; message: string; }</code>
+
+
+#### OutputOverrideType
+
+Output override type.
+- `default`: Use the system-selected route.
+- `speaker`: Force playback through the built-in speaker.
+
+<code>'default' | 'speaker'</code>
+
+
+#### RouteChangeListener
+
+Listener called when the audio route changes.
+
+<code>(reason: <a href="#routechangereasons">RouteChangeReasons</a>): void</code>
+
+
+#### InterruptionListener
+
+Listener called when the audio session is interrupted or ends.
+
+<code>(type: <a href="#interruptiontypes">InterruptionTypes</a>): void</code>
+
+
+### Enums
+
+
+#### AudioSessionPorts
+
+| Members                 | Value                           |
+| ----------------------- | ------------------------------- |
+| **`AIR_PLAY`**          | <code>'airplay'</code>          |
+| **`BLUETOOTH_LE`**      | <code>'bluetooth-le'</code>     |
+| **`BLUETOOTH_HFP`**     | <code>'bluetooth-hfp'</code>    |
+| **`BLUETOOTH_A2DP`**    | <code>'bluetooth-a2dp'</code>   |
+| **`BUILT_IN_SPEAKER`**  | <code>'builtin-speaker'</code>  |
+| **`BUILT_IN_RECEIVER`** | <code>'builtin-receiver'</code> |
+| **`HDMI`**              | <code>'hdmi'</code>             |
+| **`HEADPHONES`**        | <code>'headphones'</code>       |
+| **`LINE_OUT`**          | <code>'line-out'</code>         |
+
+
+#### RouteChangeReasons
+
+| Members                              | Value                                         |
+| ------------------------------------ | --------------------------------------------- |
+| **`NEW_DEVICE_AVAILABLE`**           | <code>'new-device-available'</code>           |
+| **`OLD_DEVICE_UNAVAILABLE`**         | <code>'old-device-unavailable'</code>         |
+| **`CATEGORY_CHANGE`**                | <code>'category-change'</code>                |
+| **`OVERRIDE`**                       | <code>'override'</code>                       |
+| **`WAKE_FROM_SLEEP`**                | <code>'wake-from-sleep'</code>                |
+| **`NO_SUITABLE_ROUTE_FOR_CATEGORY`** | <code>'no-suitable-route-for-category'</code> |
+| **`ROUTE_CONFIGURATION_CHANGE`**     | <code>'route-config-change'</code>            |
+| **`UNKNOWN`**                        | <code>'unknown'</code>                        |
+
+
+#### InterruptionTypes
+
+| Members     | Value                |
+| ----------- | -------------------- |
+| **`BEGAN`** | <code>'began'</code> |
+| **`ENDED`** | <code>'ended'</code> |
+
+</docgen-api>
+
+## License
+
+MIT
+

package/android/build.gradle

@@ -0,0 +1,58 @@
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.0'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.2.1'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.6.1'
+}
+
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.7.2'
+    }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+    namespace "ee.forgr.capacitor.audio.session"
+    compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 35
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 23
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 35
+        versionCode 1
+        versionName "1.0"
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+    lintOptions {
+        abortOnError false
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_21
+        targetCompatibility JavaVersion.VERSION_21
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+}
+
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    testImplementation "junit:junit:$junitVersion"
+    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
+    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,17 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+    <uses-permission android:name="android.permission.USE_CREDENTIALS" />
+    <uses-permission android:name="android.permission.INTERNET"/>
+    
+    <!-- Remove AD_ID permission if you're not using Facebook login to avoid Google Play Console errors -->
+    <!-- Uncomment the line below if you're only using Google/Apple login and getting AD_ID permission errors -->
+    <!-- <uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove" /> -->
+    
+    <application>
+        <provider 
+            android:name="com.facebook.internal.FacebookInitProvider"
+            android:authorities="${applicationId}.FacebookInitProvider"
+            android:exported="false"
+            tools:node="remove" />
+    </application>
+</manifest>

package/android/src/main/java/ee/forgr/capacitor/audio/session/AudioSessionPlugin.java

@@ -0,0 +1,32 @@
+package ee.forgr.capacitor.audio.session;
+
+import android.content.Intent;
+import android.os.Build;
+import android.util.Log;
+import com.getcapacitor.JSArray;
+import com.getcapacitor.JSObject;
+import com.getcapacitor.Plugin;
+import com.getcapacitor.PluginCall;
+import com.getcapacitor.PluginMethod;
+import com.getcapacitor.annotation.CapacitorPlugin;
+import java.util.HashMap;
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+@CapacitorPlugin(name = "AudioSession")
+public class AudioSessionPlugin extends Plugin {
+
+    public static String LOG_TAG = "CapgoAudioSession";
+
+    @PluginMethod
+    public void currentOutputs(PluginCall call) {
+        call.resolve();
+    }
+
+    @PluginMethod
+    public void overrideOutput(PluginCall call) {
+        call.resolve();
+    }
+
+}

package/dist/docs.json

@@ -0,0 +1,320 @@
+{
+  "api": {
+    "name": "AudioSessionPlugin",
+    "slug": "audiosessionplugin",
+    "docs": "iOS-only plugin to query and control the audio session output and listen to\nroute changes and interruptions.",
+    "tags": [],
+    "methods": [
+      {
+        "name": "currentOutputs",
+        "signature": "() => Promise<AudioSessionPorts[]>",
+        "parameters": [],
+        "returns": "Promise<AudioSessionPorts[]>",
+        "tags": [],
+        "docs": "Get the current active audio output routes.\n\nOn web and non-iOS platforms, this resolves to an empty array.",
+        "complexTypes": [
+          "AudioSessionPorts"
+        ],
+        "slug": "currentoutputs"
+      },
+      {
+        "name": "overrideOutput",
+        "signature": "(type: OutputOverrideType) => Promise<OverrideResult>",
+        "parameters": [
+          {
+            "name": "type",
+            "docs": "The desired output override type.",
+            "type": "OutputOverrideType"
+          }
+        ],
+        "returns": "Promise<OverrideResult>",
+        "tags": [
+          {
+            "name": "param",
+            "text": "type The desired output override type."
+          }
+        ],
+        "docs": "Override the current audio output route.\n\nUse `speaker` to force playback through the built-in speaker, or\n`default` to restore the system-selected route.",
+        "complexTypes": [
+          "OverrideResult",
+          "OutputOverrideType"
+        ],
+        "slug": "overrideoutput"
+      },
+      {
+        "name": "addListener",
+        "signature": "(eventName: 'routeChanged', listenerFunc: RouteChangeListener) => Promise<PluginListenerHandle>",
+        "parameters": [
+          {
+            "name": "eventName",
+            "docs": "The route change event name.",
+            "type": "'routeChanged'"
+          },
+          {
+            "name": "listenerFunc",
+            "docs": "Callback invoked with the route change reason.",
+            "type": "RouteChangeListener"
+          }
+        ],
+        "returns": "Promise<PluginListenerHandle>",
+        "tags": [
+          {
+            "name": "param",
+            "text": "eventName The route change event name."
+          },
+          {
+            "name": "param",
+            "text": "listenerFunc Callback invoked with the route change reason."
+          }
+        ],
+        "docs": "Listen for audio route changes (e.g. headset connected/disconnected).",
+        "complexTypes": [
+          "PluginListenerHandle",
+          "RouteChangeListener"
+        ],
+        "slug": "addlistenerroutechanged-"
+      },
+      {
+        "name": "addListener",
+        "signature": "(eventName: 'interruption', listenerFunc: InterruptionListener) => Promise<PluginListenerHandle>",
+        "parameters": [
+          {
+            "name": "eventName",
+            "docs": "The interruption event name.",
+            "type": "'interruption'"
+          },
+          {
+            "name": "listenerFunc",
+            "docs": "Callback invoked with the interruption type.",
+            "type": "InterruptionListener"
+          }
+        ],
+        "returns": "Promise<PluginListenerHandle>",
+        "tags": [
+          {
+            "name": "param",
+            "text": "eventName The interruption event name."
+          },
+          {
+            "name": "param",
+            "text": "listenerFunc Callback invoked with the interruption type."
+          }
+        ],
+        "docs": "Listen for audio session interruptions (e.g. incoming call) and their end.",
+        "complexTypes": [
+          "PluginListenerHandle",
+          "InterruptionListener"
+        ],
+        "slug": "addlistenerinterruption-"
+      }
+    ],
+    "properties": []
+  },
+  "interfaces": [
+    {
+      "name": "PluginListenerHandle",
+      "slug": "pluginlistenerhandle",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "remove",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "() => Promise<void>"
+        }
+      ]
+    }
+  ],
+  "enums": [
+    {
+      "name": "AudioSessionPorts",
+      "slug": "audiosessionports",
+      "members": [
+        {
+          "name": "AIR_PLAY",
+          "value": "'airplay'",
+          "tags": [],
+          "docs": ""
+        },
+        {
+          "name": "BLUETOOTH_LE",
+          "value": "'bluetooth-le'",
+          "tags": [],
+          "docs": ""
+        },
+        {
+          "name": "BLUETOOTH_HFP",
+          "value": "'bluetooth-hfp'",
+          "tags": [],
+          "docs": ""
+        },
+        {
+          "name": "BLUETOOTH_A2DP",
+          "value": "'bluetooth-a2dp'",
+          "tags": [],
+          "docs": ""
+        },
+        {
+          "name": "BUILT_IN_SPEAKER",
+          "value": "'builtin-speaker'",
+          "tags": [],
+          "docs": ""
+        },
+        {
+          "name": "BUILT_IN_RECEIVER",
+          "value": "'builtin-receiver'",
+          "tags": [],
+          "docs": ""
+        },
+        {
+          "name": "HDMI",
+          "value": "'hdmi'",
+          "tags": [],
+          "docs": ""
+        },
+        {
+          "name": "HEADPHONES",
+          "value": "'headphones'",
+          "tags": [],
+          "docs": ""
+        },
+        {
+          "name": "LINE_OUT",
+          "value": "'line-out'",
+          "tags": [],
+          "docs": ""
+        }
+      ]
+    },
+    {
+      "name": "RouteChangeReasons",
+      "slug": "routechangereasons",
+      "members": [
+        {
+          "name": "NEW_DEVICE_AVAILABLE",
+          "value": "'new-device-available'",
+          "tags": [],
+          "docs": ""
+        },
+        {
+          "name": "OLD_DEVICE_UNAVAILABLE",
+          "value": "'old-device-unavailable'",
+          "tags": [],
+          "docs": ""
+        },
+        {
+          "name": "CATEGORY_CHANGE",
+          "value": "'category-change'",
+          "tags": [],
+          "docs": ""
+        },
+        {
+          "name": "OVERRIDE",
+          "value": "'override'",
+          "tags": [],
+          "docs": ""
+        },
+        {
+          "name": "WAKE_FROM_SLEEP",
+          "value": "'wake-from-sleep'",
+          "tags": [],
+          "docs": ""
+        },
+        {
+          "name": "NO_SUITABLE_ROUTE_FOR_CATEGORY",
+          "value": "'no-suitable-route-for-category'",
+          "tags": [],
+          "docs": ""
+        },
+        {
+          "name": "ROUTE_CONFIGURATION_CHANGE",
+          "value": "'route-config-change'",
+          "tags": [],
+          "docs": ""
+        },
+        {
+          "name": "UNKNOWN",
+          "value": "'unknown'",
+          "tags": [],
+          "docs": ""
+        }
+      ]
+    },
+    {
+      "name": "InterruptionTypes",
+      "slug": "interruptiontypes",
+      "members": [
+        {
+          "name": "BEGAN",
+          "value": "'began'",
+          "tags": [],
+          "docs": ""
+        },
+        {
+          "name": "ENDED",
+          "value": "'ended'",
+          "tags": [],
+          "docs": ""
+        }
+      ]
+    }
+  ],
+  "typeAliases": [
+    {
+      "name": "OverrideResult",
+      "slug": "overrideresult",
+      "docs": "Result of an output override request.",
+      "types": [
+        {
+          "text": "{\n  success: boolean;\n  message: string;\n}",
+          "complexTypes": []
+        }
+      ]
+    },
+    {
+      "name": "OutputOverrideType",
+      "slug": "outputoverridetype",
+      "docs": "Output override type.\n- `default`: Use the system-selected route.\n- `speaker`: Force playback through the built-in speaker.",
+      "types": [
+        {
+          "text": "'default'",
+          "complexTypes": []
+        },
+        {
+          "text": "'speaker'",
+          "complexTypes": []
+        }
+      ]
+    },
+    {
+      "name": "RouteChangeListener",
+      "slug": "routechangelistener",
+      "docs": "Listener called when the audio route changes.",
+      "types": [
+        {
+          "text": "(reason: RouteChangeReasons): void",
+          "complexTypes": [
+            "RouteChangeReasons"
+          ]
+        }
+      ]
+    },
+    {
+      "name": "InterruptionListener",
+      "slug": "interruptionlistener",
+      "docs": "Listener called when the audio session is interrupted or ends.",
+      "types": [
+        {
+          "text": "(type: InterruptionTypes): void",
+          "complexTypes": [
+            "InterruptionTypes"
+          ]
+        }
+      ]
+    }
+  ],
+  "pluginConfigs": []
+}

package/dist/esm/definitions.d.ts

@@ -0,0 +1,85 @@
+import type { PluginListenerHandle } from '@capacitor/core';
+export declare enum RouteChangeReasons {
+    NEW_DEVICE_AVAILABLE = "new-device-available",
+    OLD_DEVICE_UNAVAILABLE = "old-device-unavailable",
+    CATEGORY_CHANGE = "category-change",
+    OVERRIDE = "override",
+    WAKE_FROM_SLEEP = "wake-from-sleep",
+    NO_SUITABLE_ROUTE_FOR_CATEGORY = "no-suitable-route-for-category",
+    ROUTE_CONFIGURATION_CHANGE = "route-config-change",
+    UNKNOWN = "unknown"
+}
+export declare enum InterruptionTypes {
+    BEGAN = "began",
+    ENDED = "ended"
+}
+/**
+ * Available audio output routes on iOS.
+ */
+export declare enum AudioSessionPorts {
+    AIR_PLAY = "airplay",
+    BLUETOOTH_LE = "bluetooth-le",
+    BLUETOOTH_HFP = "bluetooth-hfp",
+    BLUETOOTH_A2DP = "bluetooth-a2dp",
+    BUILT_IN_SPEAKER = "builtin-speaker",
+    BUILT_IN_RECEIVER = "builtin-receiver",
+    HDMI = "hdmi",
+    HEADPHONES = "headphones",
+    LINE_OUT = "line-out"
+}
+/**
+ * Result of an output override request.
+ */
+export declare type OverrideResult = {
+    success: boolean;
+    message: string;
+};
+/**
+ * Output override type.
+ * - `default`: Use the system-selected route.
+ * - `speaker`: Force playback through the built-in speaker.
+ */
+export declare type OutputOverrideType = 'default' | 'speaker';
+/**
+ * Listener called when the audio route changes.
+ */
+export declare type RouteChangeListener = (reason: RouteChangeReasons) => void;
+/**
+ * Listener called when the audio session is interrupted or ends.
+ */
+export declare type InterruptionListener = (type: InterruptionTypes) => void;
+/**
+ * iOS-only plugin to query and control the audio session output and listen to
+ * route changes and interruptions.
+ */
+export interface AudioSessionPlugin {
+    /**
+     * Get the current active audio output routes.
+     *
+     * On web and non-iOS platforms, this resolves to an empty array.
+     */
+    currentOutputs(): Promise<AudioSessionPorts[]>;
+    /**
+     * Override the current audio output route.
+     *
+     * Use `speaker` to force playback through the built-in speaker, or
+     * `default` to restore the system-selected route.
+     *
+     * @param type The desired output override type.
+     */
+    overrideOutput(type: OutputOverrideType): Promise<OverrideResult>;
+    /**
+     * Listen for audio route changes (e.g. headset connected/disconnected).
+     *
+     * @param eventName The route change event name.
+     * @param listenerFunc Callback invoked with the route change reason.
+     */
+    addListener(eventName: 'routeChanged', listenerFunc: RouteChangeListener): Promise<PluginListenerHandle>;
+    /**
+     * Listen for audio session interruptions (e.g. incoming call) and their end.
+     *
+     * @param eventName The interruption event name.
+     * @param listenerFunc Callback invoked with the interruption type.
+     */
+    addListener(eventName: 'interruption', listenerFunc: InterruptionListener): Promise<PluginListenerHandle>;
+}

package/dist/esm/definitions.js

@@ -0,0 +1,32 @@
+export var RouteChangeReasons;
+(function (RouteChangeReasons) {
+    RouteChangeReasons["NEW_DEVICE_AVAILABLE"] = "new-device-available";
+    RouteChangeReasons["OLD_DEVICE_UNAVAILABLE"] = "old-device-unavailable";
+    RouteChangeReasons["CATEGORY_CHANGE"] = "category-change";
+    RouteChangeReasons["OVERRIDE"] = "override";
+    RouteChangeReasons["WAKE_FROM_SLEEP"] = "wake-from-sleep";
+    RouteChangeReasons["NO_SUITABLE_ROUTE_FOR_CATEGORY"] = "no-suitable-route-for-category";
+    RouteChangeReasons["ROUTE_CONFIGURATION_CHANGE"] = "route-config-change";
+    RouteChangeReasons["UNKNOWN"] = "unknown";
+})(RouteChangeReasons || (RouteChangeReasons = {}));
+export var InterruptionTypes;
+(function (InterruptionTypes) {
+    InterruptionTypes["BEGAN"] = "began";
+    InterruptionTypes["ENDED"] = "ended";
+})(InterruptionTypes || (InterruptionTypes = {}));
+/**
+ * Available audio output routes on iOS.
+ */
+export var AudioSessionPorts;
+(function (AudioSessionPorts) {
+    AudioSessionPorts["AIR_PLAY"] = "airplay";
+    AudioSessionPorts["BLUETOOTH_LE"] = "bluetooth-le";
+    AudioSessionPorts["BLUETOOTH_HFP"] = "bluetooth-hfp";
+    AudioSessionPorts["BLUETOOTH_A2DP"] = "bluetooth-a2dp";
+    AudioSessionPorts["BUILT_IN_SPEAKER"] = "builtin-speaker";
+    AudioSessionPorts["BUILT_IN_RECEIVER"] = "builtin-receiver";
+    AudioSessionPorts["HDMI"] = "hdmi";
+    AudioSessionPorts["HEADPHONES"] = "headphones";
+    AudioSessionPorts["LINE_OUT"] = "line-out";
+})(AudioSessionPorts || (AudioSessionPorts = {}));
+//# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,kBASX;AATD,WAAY,kBAAkB;IAC5B,mEAA6C,CAAA;IAC7C,uEAAiD,CAAA;IACjD,yDAAmC,CAAA;IACnC,2CAAqB,CAAA;IACrB,yDAAmC,CAAA;IACnC,uFAAiE,CAAA;IACjE,wEAAkD,CAAA;IAClD,yCAAmB,CAAA;AACrB,CAAC,EATW,kBAAkB,KAAlB,kBAAkB,QAS7B;AAED,MAAM,CAAN,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IAC3B,oCAAe,CAAA;IACf,oCAAe,CAAA;AACjB,CAAC,EAHW,iBAAiB,KAAjB,iBAAiB,QAG5B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,iBAUX;AAVD,WAAY,iBAAiB;IAC3B,yCAAoB,CAAA;IACpB,kDAA6B,CAAA;IAC7B,oDAA+B,CAAA;IAC/B,sDAAiC,CAAA;IACjC,yDAAoC,CAAA;IACpC,2DAAsC,CAAA;IACtC,kCAAa,CAAA;IACb,8CAAyB,CAAA;IACzB,0CAAqB,CAAA;AACvB,CAAC,EAVW,iBAAiB,KAAjB,iBAAiB,QAU5B","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nexport enum RouteChangeReasons {\n  NEW_DEVICE_AVAILABLE = 'new-device-available',\n  OLD_DEVICE_UNAVAILABLE = 'old-device-unavailable',\n  CATEGORY_CHANGE = 'category-change',\n  OVERRIDE = 'override',\n  WAKE_FROM_SLEEP = 'wake-from-sleep',\n  NO_SUITABLE_ROUTE_FOR_CATEGORY = 'no-suitable-route-for-category',\n  ROUTE_CONFIGURATION_CHANGE = 'route-config-change',\n  UNKNOWN = 'unknown',\n}\n\nexport enum InterruptionTypes {\n  BEGAN = 'began',\n  ENDED = 'ended',\n}\n\n/**\n * Available audio output routes on iOS.\n */\nexport enum AudioSessionPorts {\n  AIR_PLAY = 'airplay',\n  BLUETOOTH_LE = 'bluetooth-le',\n  BLUETOOTH_HFP = 'bluetooth-hfp',\n  BLUETOOTH_A2DP = 'bluetooth-a2dp',\n  BUILT_IN_SPEAKER = 'builtin-speaker',\n  BUILT_IN_RECEIVER = 'builtin-receiver',\n  HDMI = 'hdmi',\n  HEADPHONES = 'headphones',\n  LINE_OUT = 'line-out',\n}\n\n/**\n * Result of an output override request.\n */\nexport type OverrideResult = {\n  success: boolean;\n  message: string;\n};\n\n/**\n * Output override type.\n * - `default`: Use the system-selected route.\n * - `speaker`: Force playback through the built-in speaker.\n */\nexport type OutputOverrideType = 'default' | 'speaker';\n\n/**\n * Listener called when the audio route changes.\n */\nexport type RouteChangeListener = (reason: RouteChangeReasons) => void;\n/**\n * Listener called when the audio session is interrupted or ends.\n */\nexport type InterruptionListener = (type: InterruptionTypes) => void;\n/**\n * iOS-only plugin to query and control the audio session output and listen to\n * route changes and interruptions.\n */\nexport interface AudioSessionPlugin {\n  /**\n   * Get the current active audio output routes.\n   *\n   * On web and non-iOS platforms, this resolves to an empty array.\n   */\n  currentOutputs(): Promise<AudioSessionPorts[]>;\n  /**\n   * Override the current audio output route.\n   *\n   * Use `speaker` to force playback through the built-in speaker, or\n   * `default` to restore the system-selected route.\n   *\n   * @param type The desired output override type.\n   */\n  overrideOutput(type: OutputOverrideType): Promise<OverrideResult>;\n  /**\n   * Listen for audio route changes (e.g. headset connected/disconnected).\n   *\n   * @param eventName The route change event name.\n   * @param listenerFunc Callback invoked with the route change reason.\n   */\n  addListener(eventName: 'routeChanged', listenerFunc: RouteChangeListener): Promise<PluginListenerHandle>;\n  /**\n   * Listen for audio session interruptions (e.g. incoming call) and their end.\n   *\n   * @param eventName The interruption event name.\n   * @param listenerFunc Callback invoked with the interruption type.\n   */\n  addListener(eventName: 'interruption', listenerFunc: InterruptionListener): Promise<PluginListenerHandle>;\n}\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+import type { AudioSessionPlugin } from './definitions';
+declare const AudioSession: AudioSessionPlugin;
+export * from './definitions';
+export { AudioSession };

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+import { registerPlugin } from '@capacitor/core';
+const AudioSession = registerPlugin('AudioSession', {
+    web: () => import('./web').then((m) => new m.AudioSessionWeb()),
+});
+export * from './definitions';
+export { AudioSession };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,YAAY,GAAG,cAAc,CAAqB,cAAc,EAAE;IACtE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;CAChE,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { AudioSessionPlugin } from './definitions';\n\nconst AudioSession = registerPlugin<AudioSessionPlugin>('AudioSession', {\n  web: () => import('./web').then((m) => new m.AudioSessionWeb()),\n});\n\nexport * from './definitions';\nexport { AudioSession };\n"]}

package/dist/esm/web.d.ts

@@ -0,0 +1,6 @@
+import { WebPlugin } from '@capacitor/core';
+import type { AudioSessionPlugin, AudioSessionPorts, OutputOverrideType, OverrideResult } from './definitions';
+export declare class AudioSessionWeb extends WebPlugin implements AudioSessionPlugin {
+    currentOutputs(): Promise<AudioSessionPorts[]>;
+    overrideOutput(type: OutputOverrideType): Promise<OverrideResult>;
+}

package/dist/esm/web.js

@@ -0,0 +1,15 @@
+import { WebPlugin } from '@capacitor/core';
+export class AudioSessionWeb extends WebPlugin {
+    async currentOutputs() {
+        console.log('AudioSessionPlugin.currentOutputs()', 'only available on a iOS device.');
+        return [];
+    }
+    async overrideOutput(type) {
+        console.log(`AudioSessionPlugin.currentOutputs(${type})`, 'only available on a iOS device.');
+        return {
+            success: false,
+            message: '',
+        };
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C,KAAK,CAAC,cAAc;QAClB,OAAO,CAAC,GAAG,CAAC,qCAAqC,EAAE,iCAAiC,CAAC,CAAC;QAEtF,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAAwB;QAC3C,OAAO,CAAC,GAAG,CAAC,qCAAqC,IAAI,GAAG,EAAE,iCAAiC,CAAC,CAAC;QAE7F,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type { AudioSessionPlugin, AudioSessionPorts, OutputOverrideType, OverrideResult } from './definitions';\n\nexport class AudioSessionWeb extends WebPlugin implements AudioSessionPlugin {\n  async currentOutputs(): Promise<AudioSessionPorts[]> {\n    console.log('AudioSessionPlugin.currentOutputs()', 'only available on a iOS device.');\n\n    return [];\n  }\n\n  async overrideOutput(type: OutputOverrideType): Promise<OverrideResult> {\n    console.log(`AudioSessionPlugin.currentOutputs(${type})`, 'only available on a iOS device.');\n\n    return {\n      success: false,\n      message: '',\n    };\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -0,0 +1,61 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+exports.RouteChangeReasons = void 0;
+(function (RouteChangeReasons) {
+    RouteChangeReasons["NEW_DEVICE_AVAILABLE"] = "new-device-available";
+    RouteChangeReasons["OLD_DEVICE_UNAVAILABLE"] = "old-device-unavailable";
+    RouteChangeReasons["CATEGORY_CHANGE"] = "category-change";
+    RouteChangeReasons["OVERRIDE"] = "override";
+    RouteChangeReasons["WAKE_FROM_SLEEP"] = "wake-from-sleep";
+    RouteChangeReasons["NO_SUITABLE_ROUTE_FOR_CATEGORY"] = "no-suitable-route-for-category";
+    RouteChangeReasons["ROUTE_CONFIGURATION_CHANGE"] = "route-config-change";
+    RouteChangeReasons["UNKNOWN"] = "unknown";
+})(exports.RouteChangeReasons || (exports.RouteChangeReasons = {}));
+exports.InterruptionTypes = void 0;
+(function (InterruptionTypes) {
+    InterruptionTypes["BEGAN"] = "began";
+    InterruptionTypes["ENDED"] = "ended";
+})(exports.InterruptionTypes || (exports.InterruptionTypes = {}));
+/**
+ * Available audio output routes on iOS.
+ */
+exports.AudioSessionPorts = void 0;
+(function (AudioSessionPorts) {
+    AudioSessionPorts["AIR_PLAY"] = "airplay";
+    AudioSessionPorts["BLUETOOTH_LE"] = "bluetooth-le";
+    AudioSessionPorts["BLUETOOTH_HFP"] = "bluetooth-hfp";
+    AudioSessionPorts["BLUETOOTH_A2DP"] = "bluetooth-a2dp";
+    AudioSessionPorts["BUILT_IN_SPEAKER"] = "builtin-speaker";
+    AudioSessionPorts["BUILT_IN_RECEIVER"] = "builtin-receiver";
+    AudioSessionPorts["HDMI"] = "hdmi";
+    AudioSessionPorts["HEADPHONES"] = "headphones";
+    AudioSessionPorts["LINE_OUT"] = "line-out";
+})(exports.AudioSessionPorts || (exports.AudioSessionPorts = {}));
+
+const AudioSession = core.registerPlugin('AudioSession', {
+    web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.AudioSessionWeb()),
+});
+
+class AudioSessionWeb extends core.WebPlugin {
+    async currentOutputs() {
+        console.log('AudioSessionPlugin.currentOutputs()', 'only available on a iOS device.');
+        return [];
+    }
+    async overrideOutput(type) {
+        console.log(`AudioSessionPlugin.currentOutputs(${type})`, 'only available on a iOS device.');
+        return {
+            success: false,
+            message: '',
+        };
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    AudioSessionWeb: AudioSessionWeb
+});
+
+exports.AudioSession = AudioSession;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["export var RouteChangeReasons;\n(function (RouteChangeReasons) {\n    RouteChangeReasons[\"NEW_DEVICE_AVAILABLE\"] = \"new-device-available\";\n    RouteChangeReasons[\"OLD_DEVICE_UNAVAILABLE\"] = \"old-device-unavailable\";\n    RouteChangeReasons[\"CATEGORY_CHANGE\"] = \"category-change\";\n    RouteChangeReasons[\"OVERRIDE\"] = \"override\";\n    RouteChangeReasons[\"WAKE_FROM_SLEEP\"] = \"wake-from-sleep\";\n    RouteChangeReasons[\"NO_SUITABLE_ROUTE_FOR_CATEGORY\"] = \"no-suitable-route-for-category\";\n    RouteChangeReasons[\"ROUTE_CONFIGURATION_CHANGE\"] = \"route-config-change\";\n    RouteChangeReasons[\"UNKNOWN\"] = \"unknown\";\n})(RouteChangeReasons || (RouteChangeReasons = {}));\nexport var InterruptionTypes;\n(function (InterruptionTypes) {\n    InterruptionTypes[\"BEGAN\"] = \"began\";\n    InterruptionTypes[\"ENDED\"] = \"ended\";\n})(InterruptionTypes || (InterruptionTypes = {}));\n/**\n * Available audio output routes on iOS.\n */\nexport var AudioSessionPorts;\n(function (AudioSessionPorts) {\n    AudioSessionPorts[\"AIR_PLAY\"] = \"airplay\";\n    AudioSessionPorts[\"BLUETOOTH_LE\"] = \"bluetooth-le\";\n    AudioSessionPorts[\"BLUETOOTH_HFP\"] = \"bluetooth-hfp\";\n    AudioSessionPorts[\"BLUETOOTH_A2DP\"] = \"bluetooth-a2dp\";\n    AudioSessionPorts[\"BUILT_IN_SPEAKER\"] = \"builtin-speaker\";\n    AudioSessionPorts[\"BUILT_IN_RECEIVER\"] = \"builtin-receiver\";\n    AudioSessionPorts[\"HDMI\"] = \"hdmi\";\n    AudioSessionPorts[\"HEADPHONES\"] = \"headphones\";\n    AudioSessionPorts[\"LINE_OUT\"] = \"line-out\";\n})(AudioSessionPorts || (AudioSessionPorts = {}));\n//# sourceMappingURL=definitions.js.map","import { registerPlugin } from '@capacitor/core';\nconst AudioSession = registerPlugin('AudioSession', {\n    web: () => import('./web').then((m) => new m.AudioSessionWeb()),\n});\nexport * from './definitions';\nexport { AudioSession };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class AudioSessionWeb extends WebPlugin {\n    async currentOutputs() {\n        console.log('AudioSessionPlugin.currentOutputs()', 'only available on a iOS device.');\n        return [];\n    }\n    async overrideOutput(type) {\n        console.log(`AudioSessionPlugin.currentOutputs(${type})`, 'only available on a iOS device.');\n        return {\n            success: false,\n            message: '',\n        };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["RouteChangeReasons","InterruptionTypes","AudioSessionPorts","registerPlugin","WebPlugin"],"mappings":";;;;AAAWA;AACX,CAAC,UAAU,kBAAkB,EAAE;AAC/B,IAAI,kBAAkB,CAAC,sBAAsB,CAAC,GAAG,sBAAsB;AACvE,IAAI,kBAAkB,CAAC,wBAAwB,CAAC,GAAG,wBAAwB;AAC3E,IAAI,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,iBAAiB;AAC7D,IAAI,kBAAkB,CAAC,UAAU,CAAC,GAAG,UAAU;AAC/C,IAAI,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,iBAAiB;AAC7D,IAAI,kBAAkB,CAAC,gCAAgC,CAAC,GAAG,gCAAgC;AAC3F,IAAI,kBAAkB,CAAC,4BAA4B,CAAC,GAAG,qBAAqB;AAC5E,IAAI,kBAAkB,CAAC,SAAS,CAAC,GAAG,SAAS;AAC7C,CAAC,EAAEA,0BAAkB,KAAKA,0BAAkB,GAAG,EAAE,CAAC,CAAC;AACxCC;AACX,CAAC,UAAU,iBAAiB,EAAE;AAC9B,IAAI,iBAAiB,CAAC,OAAO,CAAC,GAAG,OAAO;AACxC,IAAI,iBAAiB,CAAC,OAAO,CAAC,GAAG,OAAO;AACxC,CAAC,EAAEA,yBAAiB,KAAKA,yBAAiB,GAAG,EAAE,CAAC,CAAC;AACjD;AACA;AACA;AACWC;AACX,CAAC,UAAU,iBAAiB,EAAE;AAC9B,IAAI,iBAAiB,CAAC,UAAU,CAAC,GAAG,SAAS;AAC7C,IAAI,iBAAiB,CAAC,cAAc,CAAC,GAAG,cAAc;AACtD,IAAI,iBAAiB,CAAC,eAAe,CAAC,GAAG,eAAe;AACxD,IAAI,iBAAiB,CAAC,gBAAgB,CAAC,GAAG,gBAAgB;AAC1D,IAAI,iBAAiB,CAAC,kBAAkB,CAAC,GAAG,iBAAiB;AAC7D,IAAI,iBAAiB,CAAC,mBAAmB,CAAC,GAAG,kBAAkB;AAC/D,IAAI,iBAAiB,CAAC,MAAM,CAAC,GAAG,MAAM;AACtC,IAAI,iBAAiB,CAAC,YAAY,CAAC,GAAG,YAAY;AAClD,IAAI,iBAAiB,CAAC,UAAU,CAAC,GAAG,UAAU;AAC9C,CAAC,EAAEA,yBAAiB,KAAKA,yBAAiB,GAAG,EAAE,CAAC,CAAC;;AC7B5C,MAAC,YAAY,GAAGC,mBAAc,CAAC,cAAc,EAAE;AACpD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;AACnE,CAAC;;ACFM,MAAM,eAAe,SAASC,cAAS,CAAC;AAC/C,IAAI,MAAM,cAAc,GAAG;AAC3B,QAAQ,OAAO,CAAC,GAAG,CAAC,qCAAqC,EAAE,iCAAiC,CAAC;AAC7F,QAAQ,OAAO,EAAE;AACjB,IAAI;AACJ,IAAI,MAAM,cAAc,CAAC,IAAI,EAAE;AAC/B,QAAQ,OAAO,CAAC,GAAG,CAAC,CAAC,kCAAkC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,iCAAiC,CAAC;AACpG,QAAQ,OAAO;AACf,YAAY,OAAO,EAAE,KAAK;AAC1B,YAAY,OAAO,EAAE,EAAE;AACvB,SAAS;AACT,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -0,0 +1,64 @@
+var capacitorAudioSession = (function (exports, core) {
+    'use strict';
+
+    exports.RouteChangeReasons = void 0;
+    (function (RouteChangeReasons) {
+        RouteChangeReasons["NEW_DEVICE_AVAILABLE"] = "new-device-available";
+        RouteChangeReasons["OLD_DEVICE_UNAVAILABLE"] = "old-device-unavailable";
+        RouteChangeReasons["CATEGORY_CHANGE"] = "category-change";
+        RouteChangeReasons["OVERRIDE"] = "override";
+        RouteChangeReasons["WAKE_FROM_SLEEP"] = "wake-from-sleep";
+        RouteChangeReasons["NO_SUITABLE_ROUTE_FOR_CATEGORY"] = "no-suitable-route-for-category";
+        RouteChangeReasons["ROUTE_CONFIGURATION_CHANGE"] = "route-config-change";
+        RouteChangeReasons["UNKNOWN"] = "unknown";
+    })(exports.RouteChangeReasons || (exports.RouteChangeReasons = {}));
+    exports.InterruptionTypes = void 0;
+    (function (InterruptionTypes) {
+        InterruptionTypes["BEGAN"] = "began";
+        InterruptionTypes["ENDED"] = "ended";
+    })(exports.InterruptionTypes || (exports.InterruptionTypes = {}));
+    /**
+     * Available audio output routes on iOS.
+     */
+    exports.AudioSessionPorts = void 0;
+    (function (AudioSessionPorts) {
+        AudioSessionPorts["AIR_PLAY"] = "airplay";
+        AudioSessionPorts["BLUETOOTH_LE"] = "bluetooth-le";
+        AudioSessionPorts["BLUETOOTH_HFP"] = "bluetooth-hfp";
+        AudioSessionPorts["BLUETOOTH_A2DP"] = "bluetooth-a2dp";
+        AudioSessionPorts["BUILT_IN_SPEAKER"] = "builtin-speaker";
+        AudioSessionPorts["BUILT_IN_RECEIVER"] = "builtin-receiver";
+        AudioSessionPorts["HDMI"] = "hdmi";
+        AudioSessionPorts["HEADPHONES"] = "headphones";
+        AudioSessionPorts["LINE_OUT"] = "line-out";
+    })(exports.AudioSessionPorts || (exports.AudioSessionPorts = {}));
+
+    const AudioSession = core.registerPlugin('AudioSession', {
+        web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.AudioSessionWeb()),
+    });
+
+    class AudioSessionWeb extends core.WebPlugin {
+        async currentOutputs() {
+            console.log('AudioSessionPlugin.currentOutputs()', 'only available on a iOS device.');
+            return [];
+        }
+        async overrideOutput(type) {
+            console.log(`AudioSessionPlugin.currentOutputs(${type})`, 'only available on a iOS device.');
+            return {
+                success: false,
+                message: '',
+            };
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        AudioSessionWeb: AudioSessionWeb
+    });
+
+    exports.AudioSession = AudioSession;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["export var RouteChangeReasons;\n(function (RouteChangeReasons) {\n    RouteChangeReasons[\"NEW_DEVICE_AVAILABLE\"] = \"new-device-available\";\n    RouteChangeReasons[\"OLD_DEVICE_UNAVAILABLE\"] = \"old-device-unavailable\";\n    RouteChangeReasons[\"CATEGORY_CHANGE\"] = \"category-change\";\n    RouteChangeReasons[\"OVERRIDE\"] = \"override\";\n    RouteChangeReasons[\"WAKE_FROM_SLEEP\"] = \"wake-from-sleep\";\n    RouteChangeReasons[\"NO_SUITABLE_ROUTE_FOR_CATEGORY\"] = \"no-suitable-route-for-category\";\n    RouteChangeReasons[\"ROUTE_CONFIGURATION_CHANGE\"] = \"route-config-change\";\n    RouteChangeReasons[\"UNKNOWN\"] = \"unknown\";\n})(RouteChangeReasons || (RouteChangeReasons = {}));\nexport var InterruptionTypes;\n(function (InterruptionTypes) {\n    InterruptionTypes[\"BEGAN\"] = \"began\";\n    InterruptionTypes[\"ENDED\"] = \"ended\";\n})(InterruptionTypes || (InterruptionTypes = {}));\n/**\n * Available audio output routes on iOS.\n */\nexport var AudioSessionPorts;\n(function (AudioSessionPorts) {\n    AudioSessionPorts[\"AIR_PLAY\"] = \"airplay\";\n    AudioSessionPorts[\"BLUETOOTH_LE\"] = \"bluetooth-le\";\n    AudioSessionPorts[\"BLUETOOTH_HFP\"] = \"bluetooth-hfp\";\n    AudioSessionPorts[\"BLUETOOTH_A2DP\"] = \"bluetooth-a2dp\";\n    AudioSessionPorts[\"BUILT_IN_SPEAKER\"] = \"builtin-speaker\";\n    AudioSessionPorts[\"BUILT_IN_RECEIVER\"] = \"builtin-receiver\";\n    AudioSessionPorts[\"HDMI\"] = \"hdmi\";\n    AudioSessionPorts[\"HEADPHONES\"] = \"headphones\";\n    AudioSessionPorts[\"LINE_OUT\"] = \"line-out\";\n})(AudioSessionPorts || (AudioSessionPorts = {}));\n//# sourceMappingURL=definitions.js.map","import { registerPlugin } from '@capacitor/core';\nconst AudioSession = registerPlugin('AudioSession', {\n    web: () => import('./web').then((m) => new m.AudioSessionWeb()),\n});\nexport * from './definitions';\nexport { AudioSession };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class AudioSessionWeb extends WebPlugin {\n    async currentOutputs() {\n        console.log('AudioSessionPlugin.currentOutputs()', 'only available on a iOS device.');\n        return [];\n    }\n    async overrideOutput(type) {\n        console.log(`AudioSessionPlugin.currentOutputs(${type})`, 'only available on a iOS device.');\n        return {\n            success: false,\n            message: '',\n        };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["RouteChangeReasons","InterruptionTypes","AudioSessionPorts","registerPlugin","WebPlugin"],"mappings":";;;AAAWA;IACX,CAAC,UAAU,kBAAkB,EAAE;IAC/B,IAAI,kBAAkB,CAAC,sBAAsB,CAAC,GAAG,sBAAsB;IACvE,IAAI,kBAAkB,CAAC,wBAAwB,CAAC,GAAG,wBAAwB;IAC3E,IAAI,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,iBAAiB;IAC7D,IAAI,kBAAkB,CAAC,UAAU,CAAC,GAAG,UAAU;IAC/C,IAAI,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,iBAAiB;IAC7D,IAAI,kBAAkB,CAAC,gCAAgC,CAAC,GAAG,gCAAgC;IAC3F,IAAI,kBAAkB,CAAC,4BAA4B,CAAC,GAAG,qBAAqB;IAC5E,IAAI,kBAAkB,CAAC,SAAS,CAAC,GAAG,SAAS;IAC7C,CAAC,EAAEA,0BAAkB,KAAKA,0BAAkB,GAAG,EAAE,CAAC,CAAC;AACxCC;IACX,CAAC,UAAU,iBAAiB,EAAE;IAC9B,IAAI,iBAAiB,CAAC,OAAO,CAAC,GAAG,OAAO;IACxC,IAAI,iBAAiB,CAAC,OAAO,CAAC,GAAG,OAAO;IACxC,CAAC,EAAEA,yBAAiB,KAAKA,yBAAiB,GAAG,EAAE,CAAC,CAAC;IACjD;IACA;IACA;AACWC;IACX,CAAC,UAAU,iBAAiB,EAAE;IAC9B,IAAI,iBAAiB,CAAC,UAAU,CAAC,GAAG,SAAS;IAC7C,IAAI,iBAAiB,CAAC,cAAc,CAAC,GAAG,cAAc;IACtD,IAAI,iBAAiB,CAAC,eAAe,CAAC,GAAG,eAAe;IACxD,IAAI,iBAAiB,CAAC,gBAAgB,CAAC,GAAG,gBAAgB;IAC1D,IAAI,iBAAiB,CAAC,kBAAkB,CAAC,GAAG,iBAAiB;IAC7D,IAAI,iBAAiB,CAAC,mBAAmB,CAAC,GAAG,kBAAkB;IAC/D,IAAI,iBAAiB,CAAC,MAAM,CAAC,GAAG,MAAM;IACtC,IAAI,iBAAiB,CAAC,YAAY,CAAC,GAAG,YAAY;IAClD,IAAI,iBAAiB,CAAC,UAAU,CAAC,GAAG,UAAU;IAC9C,CAAC,EAAEA,yBAAiB,KAAKA,yBAAiB,GAAG,EAAE,CAAC,CAAC;;AC7B5C,UAAC,YAAY,GAAGC,mBAAc,CAAC,cAAc,EAAE;IACpD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;IACnE,CAAC;;ICFM,MAAM,eAAe,SAASC,cAAS,CAAC;IAC/C,IAAI,MAAM,cAAc,GAAG;IAC3B,QAAQ,OAAO,CAAC,GAAG,CAAC,qCAAqC,EAAE,iCAAiC,CAAC;IAC7F,QAAQ,OAAO,EAAE;IACjB,IAAI;IACJ,IAAI,MAAM,cAAc,CAAC,IAAI,EAAE;IAC/B,QAAQ,OAAO,CAAC,GAAG,CAAC,CAAC,kCAAkC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,iCAAiC,CAAC;IACpG,QAAQ,OAAO;IACf,YAAY,OAAO,EAAE,KAAK;IAC1B,YAAY,OAAO,EAAE,EAAE;IACvB,SAAS;IACT,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Sources/AudioSessionPlugin/AudioSession.swift

@@ -0,0 +1,136 @@
+import Foundation
+import Capacitor
+import AVKit
+
+var AudioSessionOverrideTypes: [AVAudioSession.PortOverride: String] = [
+    .none: "none",
+    .speaker: "speaker"
+]
+
+var AudioSessionRouteChangeReasons: [AVAudioSession.RouteChangeReason: String] = [
+    .newDeviceAvailable: "new-device-available",
+    .oldDeviceUnavailable: "old-device-unavailable",
+    .categoryChange: "category-change",
+    .override: "override",
+    .wakeFromSleep: "wake-from-sleep",
+    .noSuitableRouteForCategory: "no-suitable-route-for-category",
+    .routeConfigurationChange: "route-config-change",
+    .unknown: "unknown"
+]
+
+var AudioSessionInterruptionTypes: [AVAudioSession.InterruptionType: String] = [
+    .began: "began",
+    .ended: "ended"
+]
+
+var AudioSessionPorts: [AVAudioSession.Port: String] = [
+    .airPlay: "airplay",
+    .bluetoothLE: "bluetooth-le",
+    .bluetoothHFP: "bluetooth-hfp",
+    .bluetoothA2DP: "bluetooth-a2dp",
+    .builtInSpeaker: "builtin-speaker",
+    .builtInReceiver: "builtin-receiver",
+    .HDMI: "hdmi",
+    .headphones: "headphones",
+    .lineOut: "line-out"
+]
+
+public typealias AudioSessionRouteChangeObserver = (String) -> Void
+public typealias AudioSessionInterruptionObserver = (String) -> Void
+public typealias AudioSessionOverrideCallback = (Bool, String?, Bool?) -> Void
+
+public class AudioSession: NSObject {
+
+    var routeChangeObserver: AudioSessionRouteChangeObserver?
+    var interruptionObserver: AudioSessionInterruptionObserver?
+
+    var currentOverride: String?
+
+    public func load() {
+        let nc = NotificationCenter.default
+
+        nc.addObserver(self,
+                       selector: #selector(self.handleRouteChange),
+                       name: AVAudioSession.routeChangeNotification,
+                       object: nil)
+
+        nc.addObserver(self,
+                       selector: #selector(self.handleInterruption),
+                       name: AVAudioSession.interruptionNotification,
+                       object: AVAudioSession.sharedInstance)
+    }
+
+    // EVENTS
+
+    @objc func handleRouteChange(notification: Notification) {
+        guard let userInfo = notification.userInfo,
+              let reasonValue = userInfo[AVAudioSessionRouteChangeReasonKey] as? UInt,
+              let reasonType = AVAudioSession.RouteChangeReason(rawValue: reasonValue) else { return }
+        let readableReason = AudioSessionRouteChangeReasons[reasonType] ?? "unknown"
+
+        CAPLog.print("AudioSession.handleRouteChange() changed to \(readableReason)")
+
+        self.routeChangeObserver?(readableReason)
+    }
+
+    @objc func handleInterruption(notification: Notification) {
+        guard let userInfo = notification.userInfo,
+              let interruptValue = userInfo[AVAudioSessionInterruptionTypeKey] as? UInt,
+              let interruptType = AVAudioSession.InterruptionType(rawValue: interruptValue) else { return }
+        let readableInterrupt = AudioSessionInterruptionTypes[interruptType] ?? "unknown"
+
+        CAPLog.print("AudioSession.handleInterruption() interrupted status to \(readableInterrupt)")
+
+        self.interruptionObserver?(readableInterrupt)
+    }
+
+    // METHODS
+
+    public func currentOutputs() -> [String?] {
+        let outputs = AVAudioSession.sharedInstance().currentRoute.outputs.map({AudioSessionPorts[$0.portType]})
+
+        return outputs
+    }
+
+    public func overrideOutput(_output: String, _callback: @escaping AudioSessionOverrideCallback) {
+        if _output == "unknown" {
+            return _callback(false, "No valid output provided...", nil)
+        }
+
+        if self.currentOverride == _output {
+            return _callback(true, nil, nil)
+        }
+
+        // make it async, cause in latest IOS it started to take ~1 sec and produce UI thread blocking issues
+        DispatchQueue.global(qos: .utility).async {
+            let session = AVAudioSession.sharedInstance()
+
+            // make sure the AVAudioSession is properly configured
+            do {
+                try session.setActive(true)
+                try session.setCategory(AVAudioSession.Category.playAndRecord, options: AVAudioSession.CategoryOptions.duckOthers)
+            } catch {
+                CAPLog.print("AudioSession.overrideOutput() error setting sessions settings.")
+                _callback(false, "Error setting sessions settings.", true)
+                return
+            }
+
+            do {
+                if _output == "speaker" {
+                    try session.overrideOutputAudioPort(.speaker)
+                } else {
+                    try session.overrideOutputAudioPort(.none)
+                }
+
+                self.currentOverride = _output
+
+                CAPLog.print("currentOverride: " + (self.currentOverride ?? "") + " - " + _output)
+
+                _callback(true, nil, nil)
+            } catch {
+                CAPLog.print("AudioSession.overrideOutput() could not override output port.")
+                _callback(false, "Could not override output port.", true)
+            }
+        }
+    }
+}

package/ios/Sources/AudioSessionPlugin/AudioSessionPlugin.swift

@@ -0,0 +1,53 @@
+import Foundation
+import Capacitor
+
+@objc(AudioSessionPlugin)
+public class AudioSessionPlugin: CAPPlugin, CAPBridgedPlugin {
+    public let identifier = "AudioSessionPlugin"
+    public let jsName = "AudioSession"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "currentOutputs", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "overrideOutput", returnType: CAPPluginReturnPromise),
+    ]
+    private let implementation = AudioSession()
+
+    override public func load() {
+
+        implementation.load()
+
+        implementation.interruptionObserver = { [weak self] interrupt in
+            self?.notifyListeners("interruption", data: [
+                "type": interrupt
+            ])
+        }
+
+        implementation.routeChangeObserver = { [weak self] reason in
+            self?.notifyListeners("routeChanged", data: [
+                "reason": reason
+            ])
+        }
+    }
+
+    @objc func currentOutputs(_ call: CAPPluginCall) {
+        let outputs = implementation.currentOutputs()
+
+        call.resolve([
+            "outputs": outputs
+        ])
+    }
+
+    @objc func overrideOutput(_ call: CAPPluginCall) {
+        let output = call.getString("type") ?? "unknown"
+
+        implementation.overrideOutput(_output: output) { (success, message, error) -> Void in
+            if error == true {
+                call.reject(message ?? "")
+            } else {
+                call.resolve([
+                    "success": success,
+                    "message": message ?? ""
+                ])
+            }
+        }
+    }
+}

package/ios/Tests/AudioSessionPluginTests/AudioSessionPluginTests.swift

@@ -0,0 +1,15 @@
+import XCTest
+@testable import AudioSessionPlugin
+
+class SocialLoginTests: XCTestCase {
+    func testEcho() {
+        // This is an example of a functional test case for a plugin.
+        // Use XCTAssert and related functions to verify your tests produce the correct results.
+
+        let implementation = AudioSessionPlugin()
+        let value = "Hello, World!"
+        let result = implementation.echo(value)
+
+        XCTAssertEqual(value, result)
+    }
+}

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@capgo/capacitor-audio-session",
+  "version": "7.0.2",
+  "description": "This capacitor plugin allows iOS applications to get notified audio about interrupts & route changes (for example when a headset is connected), and also query and override the audio device in use.",
+  "main": "dist/plugin.cjs.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "android/src/main/",
+    "android/build.gradle",
+    "dist/",
+    "ios/Sources",
+    "ios/Tests",
+    "Package.swift",
+    "CapgoCapacitorPluginAudioSession.podspec"
+  ],
+  "author": "Martin Donadieu <martin@capgo.app>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cap-go/capacitor-plugin-audiosession.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cap-go/capacitor-plugin-audiosession/issues"
+  },
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "native",
+    "audio",
+    "audio-session"
+  ],
+  "scripts": {
+    "verify": "npm run verify:ios && npm run verify:web",
+    "verify:ios": "xcodebuild -scheme CapgoCapacitorPluginAudioSession -destination generic/platform=iOS",
+    "verify:android": "cd android && ./gradlew clean build test && cd ..",
+    "verify:web": "npm run build",
+    "lint": "npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
+    "fmt": "npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format",
+    "eslint": "eslint . --ext ts",
+    "prettier": "prettier \"**/*.{css,html,ts,js}\"",
+    "swiftlint": "node-swiftlint",
+    "docgen": "docgen --api AudioSessionPlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs",
+    "clean": "rimraf ./dist",
+    "watch": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@capacitor/core": "^7.0.0",
+    "@capacitor/docgen": "^0.3.0",
+    "@capacitor/ios": "^7.0.0",
+    "@capacitor/android": "^7.0.0",
+    "@ionic/eslint-config": "^0.4.0",
+    "@ionic/prettier-config": "^4.0.0",
+    "@ionic/swiftlint-config": "^2.0.0",
+    "eslint": "^8.57.0",
+    "prettier": "^3.4.2",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.30.1",
+    "swiftlint": "^2.0.0",
+    "typescript": "~4.1.5",
+    "prettier-plugin-java": "^2.6.6"
+  },
+  "peerDependencies": {
+    "@capacitor/core": ">=7.0.0"
+  },
+  "prettier": "@ionic/prettier-config",
+  "swiftlint": "@ionic/swiftlint-config",
+  "eslintConfig": {
+    "extends": "@ionic/eslint-config/recommended"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    }
+  },
+  "np": {
+    "yarn": false,
+    "tests": false
+  }
+}