@capacitor/background-runner 2.2.0 → 3.0.0

package/CapacitorBackgroundRunner.podspec

@@ -10,8 +10,8 @@ Pod::Spec.new do |s|
   s.homepage = package['repository']['url']
   s.author = package['author']
   s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
-  s.source_files = 'ios/Plugin/**/*.{swift,h,m,c,cc,mm,cpp}', 'packages/capacitor-plugin/ios/Plugin/**/*.{swift,h,m,c,cc,mm,cpp}', 'packages/ios-engine/Sources/RunnerEngine/*.swift'
-  s.ios.deployment_target  = '14.0'
+  s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.ios.deployment_target  = '15.0'
   s.dependency 'Capacitor'
   s.swift_version = '5.1'
 end

package/Package.swift

@@ -0,0 +1,45 @@
+// swift-tools-version: 5.7
+// The swift-tools-version declares the minimum version of Swift required to build this package.
+
+import PackageDescription
+
+let package = Package(
+    name: "CapacitorBackgroundRunner",
+    platforms: [.iOS(.v15), .macOS(.v13)],
+    products: [
+        // Products define the executables and libraries a package produces, making them visible to other packages.
+        .library(
+            name: "CapacitorBackgroundRunner",
+            targets: ["CapacitorBackgroundRunner"]
+        )
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0")
+    ],
+    targets: [
+        // Targets are the basic building blocks of a package, defining a module or a test suite.
+        // Targets can depend on other targets in this package and products from dependencies.
+        .target(
+            name: "CapacitorBackgroundRunner",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm"),
+                "RunnerEngine"
+            ],
+            path: "ios/Sources/CapacitorBackgroundRunner"
+        ),
+        .target(
+            name: "RunnerEngine",
+            dependencies: [],
+            path: "ios/Sources/RunnerEngine"),
+        .testTarget(
+            name: "RunnerEngineTests",
+            dependencies: ["RunnerEngine"],
+            path: "ios/Tests/RunnerEngineTests"),
+        .testTarget(
+            name: "CapacitorBackgroundRunnerTests",
+            dependencies: ["CapacitorBackgroundRunner"],
+            path: "ios/Tests/CapacitorBackgroundRunnerTests"
+        )
+    ]
+)

package/README.md

@@ -23,6 +23,18 @@ If you will be making use of Geolocation or Push Notifications, enable `Location
 
 ![Configure Background Modes in Xcode](https://github.com/ionic-team/capacitor-background-runner/raw/main/docs/configure_background_modes.png)
 
+You will also need to add the following entry into your `Info.plist` file:
+```
+<key>BGTaskSchedulerPermittedIdentifiers</key>
+<array>
+  <string>com.example.background.task</string>
+</array>
+```
+
+Read about [Configuring `Info.plist`](https://capacitorjs.com/docs/ios/configuration#configuring-infoplist) in the [iOS Guide](https://capacitorjs.com/docs/ios) for more information on setting iOS permissions in Xcode.
+
+Make sure you use the same id that you use for `BGTaskSchedulerPermittedIdentifiers` (for example "com.example.background.task") in the `label` field in the plugin configuration.
+
 After enabling the Background Modes capability, add the following to your app's `AppDelegate.swift`:
 
 At the top of the file, under `import Capacitor` add:
@@ -65,8 +77,6 @@ Apple requires privacy descriptions to be specified in `Info.plist` for location
 - `NSLocationAlwaysUsageDescription` (`Privacy - Location Always Usage Description`)
 - `NSLocationWhenInUseUsageDescription` (`Privacy - Location When In Use Usage Description`)
 
-Read about [Configuring `Info.plist`](https://capacitorjs.com/docs/ios/configuration#configuring-infoplist) in the [iOS Guide](https://capacitorjs.com/docs/ios) for more information on setting iOS permissions in Xcode
-
 ## Android
 
 Insert the following line to `android/app/build.gradle`:

package/android/build.gradle

@@ -1,21 +1,21 @@
 ext {
     junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
-    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.0'
-    androidxCoreKTXVersion = project.hasProperty('androidxCoreKTXVersion') ? rootProject.ext.androidxCoreKTXVersion : '1.12.0'
-    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.2.1'
-    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.6.1'
-    workManagerVersion = project.hasProperty('workManagerVersion') ? rootProject.ext.workManagerVersion : '2.8.1'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.1'
+    androidxCoreKTXVersion = project.hasProperty('androidxCoreKTXVersion') ? rootProject.ext.androidxCoreKTXVersion : '1.17.0'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.3.0'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.7.0'
+    workManagerVersion = project.hasProperty('workManagerVersion') ? rootProject.ext.workManagerVersion : '2.11.0'
 
 }
 
 buildscript {
-    ext.kotlin_version = project.hasProperty("kotlin_version") ? rootProject.ext.kotlin_version : '1.9.25'
+    ext.kotlin_version = project.hasProperty("kotlin_version") ? rootProject.ext.kotlin_version : '2.2.20'
     repositories {
         google()
         mavenCentral()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:8.7.2'
+        classpath 'com.android.tools.build:gradle:8.13.0'
         classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
 
     }
@@ -25,11 +25,11 @@ apply plugin: 'com.android.library'
 apply plugin: 'org.jetbrains.kotlin.android'
 
 android {
-    namespace "com.capacitorjs.plugins.backgroundrunner"
-    compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 35
+    namespace = "com.capacitorjs.plugins.backgroundrunner"
+    compileSdk = project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 36
     defaultConfig {
-        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 23
-        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 35
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 24
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 36
         versionCode 1
         versionName "1.0"
         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
@@ -41,7 +41,7 @@ android {
         }
     }
     lintOptions {
-        abortOnError false
+        abortOnError = false
     }
     compileOptions {
         sourceCompatibility JavaVersion.VERSION_21

package/android/src/main/java/io/ionic/backgroundrunner/plugin/BackgroundRunnerPlugin.kt

@@ -19,7 +19,7 @@ import com.getcapacitor.Bridge
 
 
 @CapacitorPlugin(
-    name = "BackgroundRunner",
+    name = "CapacitorBackgroundRunner",
     permissions = [
         Permission(
             strings = [Manifest.permission.ACCESS_COARSE_LOCATION, Manifest.permission.ACCESS_FINE_LOCATION],

package/android/src/main/java/io/ionic/backgroundrunner/plugin/api/Device.kt

@@ -80,7 +80,7 @@ class Device (context: android.content.Context) : DeviceAPI {
         return false
     }
 
-    @SuppressWarnings("deprecation")
+    @Suppress("DEPRECATION")
     private fun getAndParseNetworkInfo(): NetworkStatus {
         val networkStatus = NetworkStatus()
         val networkInfo = connectivityManager.activeNetworkInfo

package/android/src/main/java/io/ionic/backgroundrunner/plugin/api/Notifications.kt

@@ -211,17 +211,9 @@ class Notifications(context: Context) : NotificationsAPI {
             PendingIntent.getBroadcast(context, request.id, intent, flags)
 
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S && !alarmManager.canScheduleExactAlarms()) {
-            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
-                alarmManager.setAndAllowWhileIdle(AlarmManager.RTC_WAKEUP, request.scheduleAt.time, pendingIntent);
-            } else {
-                alarmManager.set(AlarmManager.RTC, request.scheduleAt.time, pendingIntent);
-            }
+            alarmManager.setAndAllowWhileIdle(AlarmManager.RTC_WAKEUP, request.scheduleAt.time, pendingIntent)
         } else {
-            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
-                alarmManager.setExactAndAllowWhileIdle(AlarmManager.RTC_WAKEUP, request.scheduleAt.time, pendingIntent);
-            } else {
-                alarmManager.setExact(AlarmManager.RTC, request.scheduleAt.time, pendingIntent);
-            }
+            alarmManager.setExactAndAllowWhileIdle(AlarmManager.RTC_WAKEUP, request.scheduleAt.time, pendingIntent)
         }
     }
 }

package/android/src/main/java/io/ionic/backgroundrunner/plugin/api/TimedNotificationPublisher.kt

@@ -34,6 +34,7 @@ class TimedNotificationPublisher : BroadcastReceiver() {
         notificationManager.notify(id, notification)
     }
 
+    @Suppress("DEPRECATION")
     private fun getParcelableExtraLegacy(intent: Intent): android.app.Notification? {
         return intent.getParcelableExtra(NOTIFICATION_KEY)
     }

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,wCAAwC","sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n\nimport type { PermissionState, PluginListenerHandle } from '@capacitor/core';\n\nexport interface BackgroundRunnerConfig {\n  /**\n   * The name of the runner, used in logs.\n   *\n   * @since 1.0.0\n   */\n  label: string;\n  /**\n   * The path to the runner JavaScript file, relative to the app bundle.\n   *\n   * @since 1.0.0\n   */\n  src: string;\n  /**\n   * The name of the event that will be called when the OS executes the background task.\n   *\n   * @since 1.0.0\n   */\n  event: string;\n  /**\n   * If background task should repeat based on the interval set in `interval`.\n   *\n   * @since 1.0.0\n   */\n  repeat: boolean;\n  /**\n   * The number of minutes after the the app is put into the background in which the background task should begin.\n   *\n   * If `repeat` is true, this also specifies the number of minutes between each execution.\n   *\n   * @since 1.0.0\n   */\n  interval: number;\n  /**\n   * Automatically register and schedule background task on app load.\n   *\n   * @since 1.0.0\n   */\n  autoStart?: boolean;\n}\n\ndeclare module '@capacitor/cli' {\n  export interface PluginsConfig {\n    /**\n     * On load, Background Runner will automatically register a\n     * background task that will be scheduled and run once your app is\n     * backgrounded.\n     */\n    BackgroundRunner?: {\n      /**\n       * The name of the runner, used in logs.\n       *\n       * @since 1.0.0\n       * @example \"com.example.background.task\"\n       */\n      label: string;\n      /**\n       * The path to the runner JavaScript file, relative to the app bundle.\n       *\n       * @since 1.0.0\n       * @example \"runners/background.js\"\n       */\n      src: string;\n      /**\n       * The name of the event that will be called when the OS executes the background task.\n       *\n       * @since 1.0.0\n       * @example \"myCustomEvent\"\n       */\n      event: string;\n      /**\n       * If background task should repeat based on the interval set in `interval`.\n       *\n       * @since 1.0.0\n       * @example true\n       */\n      repeat: boolean;\n      /**\n       * The number of minutes after the the app is put into the background in which the background task should begin.\n       *\n       * If `repeat` is true, this also specifies the number of minutes between each execution.\n       *\n       * @since 1.0.0\n       * @example 15\n       */\n      interval: number;\n      /**\n       * Automatically register and schedule background task on app load.\n       *\n       * @since 1.0.0\n       * @example true\n       */\n      autoStart?: boolean;\n    };\n  }\n}\n\nexport type API = 'geolocation' | 'notifications';\n\nexport interface PermissionStatus {\n  geolocation: PermissionState;\n  notifications: PermissionState;\n}\n\nexport interface DispatchEventOptions {\n  /**\n   * The runner label to dispatch the event to\n   *\n   * @since 1.0.0\n   */\n  label: string;\n  /**\n   * The name of the registered event listener.\n   *\n   * @since 1.0.0\n   */\n  event: string;\n  details: { [key: string]: any };\n}\n\nexport interface RequestPermissionOptions {\n  apis: API[];\n}\n\nexport interface RegisterBackgroundTaskOptions {\n  runner: BackgroundRunnerConfig;\n}\n\nexport interface NotificationActionEvent {\n  actionTypeId: string;\n  notificationId: number;\n}\n\nexport interface BackgroundRunnerPlugin {\n  /**\n   * Check permissions for the various Capacitor device APIs.\n   *\n   * @since 1.0.0\n   */\n  checkPermissions(): Promise<PermissionStatus>;\n  /**\n   * Request permission to display local notifications.\n   *\n   * @since 1.0.0\n   */\n  requestPermissions(\n    options: RequestPermissionOptions,\n  ): Promise<PermissionStatus>;\n  /**\n   * Dispatches an event to the configured runner.\n   * @param options\n   * @since 1.0.0\n   */\n  dispatchEvent<T = void>(options: DispatchEventOptions): Promise<T>;\n  /**\n   * Add a listener for notification actions.\n   *\n   * @since 2.1.1\n   */\n  addListener(\n    eventName: 'backgroundRunnerNotificationReceived',\n    listenerFunc: (event: NotificationActionEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Remove notification action listeners for this plugin.\n   *\n   * @since 2.1.1\n   */\n  removeNotificationListeners(): Promise<void>;\n}\n\ndeclare module '@capacitor/cli' {\n  export interface PluginsConfig {\n    BackgroundRunner?: BackgroundRunnerConfig;\n  }\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,wCAAwC","sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n\nimport type { PermissionState, PluginListenerHandle } from '@capacitor/core';\n\nexport interface BackgroundRunnerConfig {\n  /**\n   * The name of the runner, used in logs.\n   *\n   * @since 1.0.0\n   */\n  label: string;\n  /**\n   * The path to the runner JavaScript file, relative to the app bundle.\n   *\n   * @since 1.0.0\n   */\n  src: string;\n  /**\n   * The name of the event that will be called when the OS executes the background task.\n   *\n   * @since 1.0.0\n   */\n  event: string;\n  /**\n   * If background task should repeat based on the interval set in `interval`.\n   *\n   * @since 1.0.0\n   */\n  repeat: boolean;\n  /**\n   * The number of minutes after the the app is put into the background in which the background task should begin.\n   *\n   * If `repeat` is true, this also specifies the number of minutes between each execution.\n   *\n   * @since 1.0.0\n   */\n  interval: number;\n  /**\n   * Automatically register and schedule background task on app load.\n   *\n   * @since 1.0.0\n   */\n  autoStart?: boolean;\n}\n\ndeclare module '@capacitor/cli' {\n  export interface PluginsConfig {\n    /**\n     * On load, Background Runner will automatically register a\n     * background task that will be scheduled and run once your app is\n     * backgrounded.\n     */\n    BackgroundRunner?: {\n      /**\n       * The name of the runner, used in logs.\n       *\n       * @since 1.0.0\n       * @example \"com.example.background.task\"\n       */\n      label: string;\n      /**\n       * The path to the runner JavaScript file, relative to the app bundle.\n       *\n       * @since 1.0.0\n       * @example \"runners/background.js\"\n       */\n      src: string;\n      /**\n       * The name of the event that will be called when the OS executes the background task.\n       *\n       * @since 1.0.0\n       * @example \"myCustomEvent\"\n       */\n      event: string;\n      /**\n       * If background task should repeat based on the interval set in `interval`.\n       *\n       * @since 1.0.0\n       * @example true\n       */\n      repeat: boolean;\n      /**\n       * The number of minutes after the the app is put into the background in which the background task should begin.\n       *\n       * If `repeat` is true, this also specifies the number of minutes between each execution.\n       *\n       * @since 1.0.0\n       * @example 15\n       */\n      interval: number;\n      /**\n       * Automatically register and schedule background task on app load.\n       *\n       * @since 1.0.0\n       * @example true\n       */\n      autoStart?: boolean;\n    };\n  }\n}\n\nexport type API = 'geolocation' | 'notifications';\n\nexport interface PermissionStatus {\n  geolocation: PermissionState;\n  notifications: PermissionState;\n}\n\nexport interface DispatchEventOptions {\n  /**\n   * The runner label to dispatch the event to\n   *\n   * @since 1.0.0\n   */\n  label: string;\n  /**\n   * The name of the registered event listener.\n   *\n   * @since 1.0.0\n   */\n  event: string;\n  details: { [key: string]: any };\n}\n\nexport interface RequestPermissionOptions {\n  apis: API[];\n}\n\nexport interface RegisterBackgroundTaskOptions {\n  runner: BackgroundRunnerConfig;\n}\n\nexport interface NotificationActionEvent {\n  actionTypeId: string;\n  notificationId: number;\n}\n\nexport interface BackgroundRunnerPlugin {\n  /**\n   * Check permissions for the various Capacitor device APIs.\n   *\n   * @since 1.0.0\n   */\n  checkPermissions(): Promise<PermissionStatus>;\n  /**\n   * Request permission to display local notifications.\n   *\n   * @since 1.0.0\n   */\n  requestPermissions(options: RequestPermissionOptions): Promise<PermissionStatus>;\n  /**\n   * Dispatches an event to the configured runner.\n   * @param options\n   * @since 1.0.0\n   */\n  dispatchEvent<T = void>(options: DispatchEventOptions): Promise<T>;\n  /**\n   * Add a listener for notification actions.\n   *\n   * @since 2.1.1\n   */\n  addListener(\n    eventName: 'backgroundRunnerNotificationReceived',\n    listenerFunc: (event: NotificationActionEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Remove notification action listeners for this plugin.\n   *\n   * @since 2.1.1\n   */\n  removeNotificationListeners(): Promise<void>;\n}\n\ndeclare module '@capacitor/cli' {\n  export interface PluginsConfig {\n    BackgroundRunner?: BackgroundRunnerConfig;\n  }\n}\n"]}

package/dist/esm/index.js

@@ -1,6 +1,6 @@
 import { registerPlugin } from '@capacitor/core';
-const BackgroundRunner = registerPlugin('BackgroundRunner', {
-    web: () => import('./web').then(m => new m.BackgroundRunnerWeb()),
+const BackgroundRunner = registerPlugin('CapacitorBackgroundRunner', {
+    web: () => import('./web').then((m) => new m.BackgroundRunnerWeb()),
 });
 export * from './definitions';
 export * from './apis';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,gBAAgB,GAAG,cAAc,CACrC,kBAAkB,EAClB;IACE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,mBAAmB,EAAE,CAAC;CAClE,CACF,CAAC;AAEF,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AAEvB,OAAO,EAAE,gBAAgB,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { BackgroundRunnerPlugin } from './definitions';\n\nconst BackgroundRunner = registerPlugin<BackgroundRunnerPlugin>(\n  'BackgroundRunner',\n  {\n    web: () => import('./web').then(m => new m.BackgroundRunnerWeb()),\n  },\n);\n\nexport * from './definitions';\nexport * from './apis';\n\nexport { BackgroundRunner };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,gBAAgB,GAAG,cAAc,CAAyB,2BAA2B,EAAE;IAC3F,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,mBAAmB,EAAE,CAAC;CACpE,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AAEvB,OAAO,EAAE,gBAAgB,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { BackgroundRunnerPlugin } from './definitions';\n\nconst BackgroundRunner = registerPlugin<BackgroundRunnerPlugin>('CapacitorBackgroundRunner', {\n  web: () => import('./web').then((m) => new m.BackgroundRunnerWeb()),\n});\n\nexport * from './definitions';\nexport * from './apis';\n\nexport { BackgroundRunner };\n"]}

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAS5C,MAAM,OAAO,mBACX,SAAQ,SAAS;IAGjB,gBAAgB;QACd,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IAED,kBAAkB;QAChB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IAED,sBAAsB;QACpB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IAED,aAAa,CAAW,QAA8B;QACpD,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,WAAW,CACf,UAAkD,EAClD,aAAuD;QAEvD,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,2BAA2B;QAC/B,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\nimport { WebPlugin } from '@capacitor/core';\n\nimport type {\n  BackgroundRunnerPlugin,\n  DispatchEventOptions,\n  PermissionStatus,\n  NotificationActionEvent,\n} from './definitions';\n\nexport class BackgroundRunnerWeb\n  extends WebPlugin\n  implements BackgroundRunnerPlugin\n{\n  checkPermissions(): Promise<PermissionStatus> {\n    throw new Error('not available on web');\n  }\n\n  requestPermissions(): Promise<PermissionStatus> {\n    throw new Error('not available on web');\n  }\n\n  registerBackgroundTask(): Promise<void> {\n    throw new Error('not available on web');\n  }\n\n  dispatchEvent<T = void>(_options: DispatchEventOptions): Promise<T> {\n    throw new Error('not available on web');\n  }\n\n  async addListener(\n    _eventName: 'backgroundRunnerNotificationReceived',\n    _listenerFunc: (event: NotificationActionEvent) => void,\n  ): Promise<PluginListenerHandle> {\n    throw new Error('not available on web');\n  }\n\n  async removeNotificationListeners(): Promise<void> {\n    throw new Error('not available on web');\n  }\n}\n"]}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAS5C,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IAChD,gBAAgB;QACd,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IAED,kBAAkB;QAChB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IAED,sBAAsB;QACpB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IAED,aAAa,CAAW,QAA8B;QACpD,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,WAAW,CACf,UAAkD,EAClD,aAAuD;QAEvD,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,2BAA2B;QAC/B,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\nimport { WebPlugin } from '@capacitor/core';\n\nimport type {\n  BackgroundRunnerPlugin,\n  DispatchEventOptions,\n  PermissionStatus,\n  NotificationActionEvent,\n} from './definitions';\n\nexport class BackgroundRunnerWeb extends WebPlugin implements BackgroundRunnerPlugin {\n  checkPermissions(): Promise<PermissionStatus> {\n    throw new Error('not available on web');\n  }\n\n  requestPermissions(): Promise<PermissionStatus> {\n    throw new Error('not available on web');\n  }\n\n  registerBackgroundTask(): Promise<void> {\n    throw new Error('not available on web');\n  }\n\n  dispatchEvent<T = void>(_options: DispatchEventOptions): Promise<T> {\n    throw new Error('not available on web');\n  }\n\n  async addListener(\n    _eventName: 'backgroundRunnerNotificationReceived',\n    _listenerFunc: (event: NotificationActionEvent) => void,\n  ): Promise<PluginListenerHandle> {\n    throw new Error('not available on web');\n  }\n\n  async removeNotificationListeners(): Promise<void> {\n    throw new Error('not available on web');\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -1,11 +1,9 @@
 'use strict';
 
-Object.defineProperty(exports, '__esModule', { value: true });
-
 var core = require('@capacitor/core');
 
-const BackgroundRunner = core.registerPlugin('BackgroundRunner', {
-    web: () => Promise.resolve().then(function () { return web; }).then(m => new m.BackgroundRunnerWeb()),
+const BackgroundRunner = core.registerPlugin('CapacitorBackgroundRunner', {
+    web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.BackgroundRunnerWeb()),
 });
 
 class BackgroundRunnerWeb extends core.WebPlugin {

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst BackgroundRunner = registerPlugin('BackgroundRunner', {\n    web: () => import('./web').then(m => new m.BackgroundRunnerWeb()),\n});\nexport * from './definitions';\nexport * from './apis';\nexport { BackgroundRunner };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class BackgroundRunnerWeb extends WebPlugin {\n    checkPermissions() {\n        throw new Error('not available on web');\n    }\n    requestPermissions() {\n        throw new Error('not available on web');\n    }\n    registerBackgroundTask() {\n        throw new Error('not available on web');\n    }\n    dispatchEvent(_options) {\n        throw new Error('not available on web');\n    }\n    async addListener(_eventName, _listenerFunc) {\n        throw new Error('not available on web');\n    }\n    async removeNotificationListeners() {\n        throw new Error('not available on web');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;;;AACK,MAAC,gBAAgB,GAAGA,mBAAc,CAAC,kBAAkB,EAAE;AAC5D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,mBAAmB,EAAE,CAAC;AACrE,CAAC;;ACFM,MAAM,mBAAmB,SAASC,cAAS,CAAC;AACnD,IAAI,gBAAgB,GAAG;AACvB,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;AAChD,KAAK;AACL,IAAI,kBAAkB,GAAG;AACzB,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;AAChD,KAAK;AACL,IAAI,sBAAsB,GAAG;AAC7B,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;AAChD,KAAK;AACL,IAAI,aAAa,CAAC,QAAQ,EAAE;AAC5B,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;AAChD,KAAK;AACL,IAAI,MAAM,WAAW,CAAC,UAAU,EAAE,aAAa,EAAE;AACjD,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;AAChD,KAAK;AACL,IAAI,MAAM,2BAA2B,GAAG;AACxC,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;AAChD,KAAK;AACL;;;;;;;;;"}
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst BackgroundRunner = registerPlugin('CapacitorBackgroundRunner', {\n    web: () => import('./web').then((m) => new m.BackgroundRunnerWeb()),\n});\nexport * from './definitions';\nexport * from './apis';\nexport { BackgroundRunner };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class BackgroundRunnerWeb extends WebPlugin {\n    checkPermissions() {\n        throw new Error('not available on web');\n    }\n    requestPermissions() {\n        throw new Error('not available on web');\n    }\n    registerBackgroundTask() {\n        throw new Error('not available on web');\n    }\n    dispatchEvent(_options) {\n        throw new Error('not available on web');\n    }\n    async addListener(_eventName, _listenerFunc) {\n        throw new Error('not available on web');\n    }\n    async removeNotificationListeners() {\n        throw new Error('not available on web');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,gBAAgB,GAAGA,mBAAc,CAAC,2BAA2B,EAAE;AACrE,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,mBAAmB,EAAE,CAAC;AACvE,CAAC;;ACFM,MAAM,mBAAmB,SAASC,cAAS,CAAC;AACnD,IAAI,gBAAgB,GAAG;AACvB,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC;AAC/C,IAAI;AACJ,IAAI,kBAAkB,GAAG;AACzB,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC;AAC/C,IAAI;AACJ,IAAI,sBAAsB,GAAG;AAC7B,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC;AAC/C,IAAI;AACJ,IAAI,aAAa,CAAC,QAAQ,EAAE;AAC5B,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC;AAC/C,IAAI;AACJ,IAAI,MAAM,WAAW,CAAC,UAAU,EAAE,aAAa,EAAE;AACjD,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC;AAC/C,IAAI;AACJ,IAAI,MAAM,2BAA2B,GAAG;AACxC,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC;AAC/C,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -1,8 +1,8 @@
 var capacitorBackgroundRunner = (function (exports, core) {
     'use strict';
 
-    const BackgroundRunner = core.registerPlugin('BackgroundRunner', {
-        web: () => Promise.resolve().then(function () { return web; }).then(m => new m.BackgroundRunnerWeb()),
+    const BackgroundRunner = core.registerPlugin('CapacitorBackgroundRunner', {
+        web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.BackgroundRunnerWeb()),
     });
 
     class BackgroundRunnerWeb extends core.WebPlugin {
@@ -33,8 +33,6 @@ var capacitorBackgroundRunner = (function (exports, core) {
 
     exports.BackgroundRunner = BackgroundRunner;
 
-    Object.defineProperty(exports, '__esModule', { value: true });
-
     return exports;
 
 })({}, capacitorExports);

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst BackgroundRunner = registerPlugin('BackgroundRunner', {\n    web: () => import('./web').then(m => new m.BackgroundRunnerWeb()),\n});\nexport * from './definitions';\nexport * from './apis';\nexport { BackgroundRunner };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class BackgroundRunnerWeb extends WebPlugin {\n    checkPermissions() {\n        throw new Error('not available on web');\n    }\n    requestPermissions() {\n        throw new Error('not available on web');\n    }\n    registerBackgroundTask() {\n        throw new Error('not available on web');\n    }\n    dispatchEvent(_options) {\n        throw new Error('not available on web');\n    }\n    async addListener(_eventName, _listenerFunc) {\n        throw new Error('not available on web');\n    }\n    async removeNotificationListeners() {\n        throw new Error('not available on web');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,gBAAgB,GAAGA,mBAAc,CAAC,kBAAkB,EAAE;IAC5D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,mBAAmB,EAAE,CAAC;IACrE,CAAC;;ICFM,MAAM,mBAAmB,SAASC,cAAS,CAAC;IACnD,IAAI,gBAAgB,GAAG;IACvB,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAChD,KAAK;IACL,IAAI,kBAAkB,GAAG;IACzB,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAChD,KAAK;IACL,IAAI,sBAAsB,GAAG;IAC7B,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAChD,KAAK;IACL,IAAI,aAAa,CAAC,QAAQ,EAAE;IAC5B,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAChD,KAAK;IACL,IAAI,MAAM,WAAW,CAAC,UAAU,EAAE,aAAa,EAAE;IACjD,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAChD,KAAK;IACL,IAAI,MAAM,2BAA2B,GAAG;IACxC,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAChD,KAAK;IACL;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst BackgroundRunner = registerPlugin('CapacitorBackgroundRunner', {\n    web: () => import('./web').then((m) => new m.BackgroundRunnerWeb()),\n});\nexport * from './definitions';\nexport * from './apis';\nexport { BackgroundRunner };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class BackgroundRunnerWeb extends WebPlugin {\n    checkPermissions() {\n        throw new Error('not available on web');\n    }\n    requestPermissions() {\n        throw new Error('not available on web');\n    }\n    registerBackgroundTask() {\n        throw new Error('not available on web');\n    }\n    dispatchEvent(_options) {\n        throw new Error('not available on web');\n    }\n    async addListener(_eventName, _listenerFunc) {\n        throw new Error('not available on web');\n    }\n    async removeNotificationListeners() {\n        throw new Error('not available on web');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,gBAAgB,GAAGA,mBAAc,CAAC,2BAA2B,EAAE;IACrE,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,mBAAmB,EAAE,CAAC;IACvE,CAAC;;ICFM,MAAM,mBAAmB,SAASC,cAAS,CAAC;IACnD,IAAI,gBAAgB,GAAG;IACvB,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC;IAC/C,IAAI;IACJ,IAAI,kBAAkB,GAAG;IACzB,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC;IAC/C,IAAI;IACJ,IAAI,sBAAsB,GAAG;IAC7B,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC;IAC/C,IAAI;IACJ,IAAI,aAAa,CAAC,QAAQ,EAAE;IAC5B,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC;IAC/C,IAAI;IACJ,IAAI,MAAM,WAAW,CAAC,UAAU,EAAE,aAAa,EAAE;IACjD,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC;IAC/C,IAAI;IACJ,IAAI,MAAM,2BAA2B,GAAG;IACxC,QAAQ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC;IAC/C,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/{Plugin → Sources/CapacitorBackgroundRunner}/BackgroundRunner.swift

@@ -1,8 +1,12 @@
-import Foundation
-import Capacitor
 import BackgroundTasks
+import Capacitor
+import Foundation
 import JavaScriptCore
 
+#if canImport(RunnerEngine)
+import RunnerEngine
+#endif
+
 public class BackgroundRunner {
     public static let shared = BackgroundRunner()
     public var config: RunnerConfig?
@@ -27,7 +31,8 @@ public class BackgroundRunner {
         }
 
         guard let interval = config.interval else {
-            throw BackgroundRunnerPluginError.invalidRunnerConfig(reason: "cannot register background task without a configured interval")
+            throw BackgroundRunnerPluginError.invalidRunnerConfig(
+                reason: "cannot register background task without a configured interval")
         }
 
         let request = BGAppRefreshTaskRequest(identifier: config.label)
@@ -64,7 +69,9 @@ public class BackgroundRunner {
     }
 
     // swiftlint:disable:next cyclomatic_complexity function_body_length
-    public func execute(config: RunnerConfig, inputArgs: [String: Any]? = nil, callbackId: String? = nil) throws -> [String: Any]? {
+    public func execute(
+        config: RunnerConfig, inputArgs: [String: Any]? = nil, callbackId: String? = nil
+    ) throws -> [String: Any]? {
         do {
             let context = try initContext(config: config, callbackId: callbackId)
 
@@ -73,7 +80,7 @@ public class BackgroundRunner {
             var result: [String: Any]?
             var rejectionErr: JSError?
 
-            let resolveFunc: @convention(block)(JavaScriptCore.JSValue) -> Void = { returnObj in
+            let resolveFunc: @convention(block) (JavaScriptCore.JSValue) -> Void = { returnObj in
                 if !returnObj.isUndefined && !returnObj.isNull {
                     var dict: [String: Any] = [:]
 
@@ -88,7 +95,7 @@ public class BackgroundRunner {
                 return
             }
 
-            let rejectFunc: @convention(block)(JavaScriptCore.JSValue) -> Void = { rejectObj in
+            let rejectFunc: @convention(block) (JavaScriptCore.JSValue) -> Void = { rejectObj in
                 var rejectionTitle = "Error"
                 var rejectionMessage = ""
 
@@ -136,7 +143,7 @@ public class BackgroundRunner {
             waitGroup.wait()
 
             if let rejection = rejectionErr {
-                throw EngineError.jsException(details: rejection.message)
+                throw EngineError.jsException(details: rejection.toString())
             }
 
             return result
@@ -146,7 +153,8 @@ public class BackgroundRunner {
         }
     }
 
-    public func dispatchEvent(event: String, inputArgs: [String: Any]?, callbackId: String? = nil) throws {
+    public func dispatchEvent(event: String, inputArgs: [String: Any]?, callbackId: String? = nil)
+    throws {
         if let config = config {
             let waitGroup = DispatchGroup()
             waitGroup.enter()
@@ -174,13 +182,17 @@ public class BackgroundRunner {
     }
 
     private func loadRunnerConfig() throws -> RunnerConfig? {
-        guard let capacitorConfigFileURL = Bundle.main.url(forResource: "capacitor.config.json", withExtension: nil) else {
+        guard
+            let capacitorConfigFileURL = Bundle.main.url(
+                forResource: "capacitor.config.json", withExtension: nil)
+        else {
             throw BackgroundRunnerPluginError.runnerError(reason: "capacitor.config.json file not found")
         }
 
         let capacitorConfigFileData = try Data(contentsOf: capacitorConfigFileURL)
 
-        if let capConfig = JSTypes.coerceDictionaryToJSObject(try JSONSerialization.jsonObject(with: capacitorConfigFileData) as? [String: Any]) {
+        if let capConfig = JSTypes.coerceDictionaryToJSObject(
+            try JSONSerialization.jsonObject(with: capacitorConfigFileData) as? [String: Any]) {
             if let jsonConfig = capConfig[keyPath: "plugins.BackgroundRunner"] as? JSObject {
                 return try RunnerConfig(from: jsonConfig)
             }
@@ -190,7 +202,10 @@ public class BackgroundRunner {
     }
 
     private func initContext(config: RunnerConfig, callbackId: String?) throws -> Context {
-        guard let srcFileURL = Bundle.main.url(forResource: config.src, withExtension: nil, subdirectory: "public") else {
+        guard
+            let srcFileURL = Bundle.main.url(
+                forResource: config.src, withExtension: nil, subdirectory: "public")
+        else {
             throw BackgroundRunnerPluginError.runnerError(reason: "source file not found")
         }
 

package/ios/{Plugin → Sources/CapacitorBackgroundRunner}/CapacitorAPI/Geolocation.swift

@@ -1,6 +1,10 @@
+import CoreLocation
 import Foundation
 import JavaScriptCore
-import CoreLocation
+
+#if canImport(RunnerEngine)
+import RunnerEngine
+#endif
 
 @objc protocol CapacitorGeolocationExports: JSExport {
     var isWatchingPosition: Bool { get }
@@ -32,9 +36,12 @@ class CapacitorGeolocation: NSObject, CapacitorGeolocationExports, CLLocationMan
         self.context = context
         self.locationManager.delegate = self
 
-        self.locationManager.allowsBackgroundLocationUpdates = true
-        self.locationManager.desiredAccuracy = kCLLocationAccuracyKilometer
-        self.locationManager.pausesLocationUpdatesAutomatically = false
+        if CLLocationManager.authorizationStatus() == .authorizedAlways {
+            self.locationManager.allowsBackgroundLocationUpdates = true
+            self.locationManager.desiredAccuracy = kCLLocationAccuracyKilometer
+            self.locationManager.pausesLocationUpdatesAutomatically = false
+        }
+
     }
 
     static func getCurrentKnownLocation() -> CLLocation? {
@@ -71,7 +78,8 @@ class CapacitorGeolocation: NSObject, CapacitorGeolocationExports, CLLocationMan
             return
         }
 
-        return try await withCheckedThrowingContinuation({ (continuation: CheckedContinuation<Void, Error>) in
+        return try await withCheckedThrowingContinuation({
+            (continuation: CheckedContinuation<Void, Error>) in
             permissionContinuation = continuation
 
             DispatchQueue.main.async {
@@ -96,7 +104,8 @@ class CapacitorGeolocation: NSObject, CapacitorGeolocationExports, CLLocationMan
 
             self.isWatchingLocation = true
         } catch {
-            JSContext.current().exception = JSValue(newErrorFromMessage: "\(error)", in: JSContext.current())
+            JSContext.current().exception = JSValue(
+                newErrorFromMessage: "\(error)", in: JSContext.current())
         }
     }
 
@@ -121,7 +130,8 @@ class CapacitorGeolocation: NSObject, CapacitorGeolocationExports, CLLocationMan
 
             return buildLocationDict(location: lastLocation)
         } catch {
-            JSContext.current().exception = JSValue(newErrorFromMessage: "\(error)", in: JSContext.current())
+            JSContext.current().exception = JSValue(
+                newErrorFromMessage: "\(error)", in: JSContext.current())
 
             return nil
         }
@@ -139,7 +149,8 @@ class CapacitorGeolocation: NSObject, CapacitorGeolocationExports, CLLocationMan
             try? context.dispatchEvent(event: "currentLocation", details: details)
         }
 
-        pendingCurrentLocationCalls.forEach { (callId: Int, callback: (Result<CLLocation?, Error>) -> Void) in
+        pendingCurrentLocationCalls.forEach {
+            (callId: Int, callback: (Result<CLLocation?, Error>) -> Void) in
             pendingCurrentLocationCalls.removeValue(forKey: callId)
             callback(.success(locations.last))
         }
@@ -162,7 +173,8 @@ class CapacitorGeolocation: NSObject, CapacitorGeolocationExports, CLLocationMan
             try? context.dispatchEvent(event: "currentLocation", details: details)
         }
 
-        pendingCurrentLocationCalls.forEach { (callId: Int, callback: (Result<CLLocation?, Error>) -> Void) in
+        pendingCurrentLocationCalls.forEach {
+            (callId: Int, callback: (Result<CLLocation?, Error>) -> Void) in
             pendingCurrentLocationCalls.removeValue(forKey: callId)
             callback(.failure(error))
         }

package/ios/{Plugin → Sources/CapacitorBackgroundRunner}/CapacitorAPI/Notifications.swift

@@ -1,4 +1,5 @@
 import Foundation
+import UIKit
 import JavaScriptCore
 import UserNotifications
 
@@ -136,7 +137,7 @@ class CapacitorNotifications: NSObject, CapacitorNotificationsExports {
                     let content = UNMutableNotificationContent()
                     content.title = NSString.localizedUserNotificationString(forKey: notificationOption.title, arguments: nil)
                     content.body = NSString.localizedUserNotificationString(forKey: notificationOption.body, arguments: nil)
-                    content.userInfo = [:]
+                    content.userInfo = ["source": "capacitor-background-runner"]
 
                     if let extra = notificationOption.extra {
                         content.userInfo["cap_extra"] = extra