@capacitor/background-runner 2.2.0 → 2.3.1

package/CapacitorBackgroundRunner.podspec

@@ -10,7 +10,7 @@ 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.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
   s.ios.deployment_target  = '14.0'
   s.dependency 'Capacitor'
   s.swift_version = '5.1'

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(.v14), .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: "7.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

@@ -5,7 +5,7 @@ Background Runner provides an event-based standalone JavaScript environment for
 ## Install
 
 ```bash
-npm install @capacitor/background-runner
+npm install @capacitor/background-runner@latest-7
 npx cap sync
 ```
 
@@ -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/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/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

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

@@ -4,8 +4,18 @@ import WatchConnectivity
 import UserNotifications
 
 @objc(BackgroundRunnerPlugin)
-public class BackgroundRunnerPlugin: CAPPlugin {
+public class BackgroundRunnerPlugin: CAPPlugin, CAPBridgedPlugin {
+    public let identifier = "CapacitorBackgroundRunnerPlugin"
+    public let jsName = "CapacitorBackgroundRunner"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "checkPermissions", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "requestPermissions", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "dispatchEvent", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "registerBackgroundTask", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "removeNotificationListeners", returnType: CAPPluginReturnPromise)
+    ]
     private let impl = BackgroundRunner()
+    private weak var originalDelegate: UNUserNotificationCenterDelegate?
 
     override public func load() {
         NotificationCenter.default.addObserver(
@@ -188,6 +198,11 @@ public class BackgroundRunnerPlugin: CAPPlugin {
     @objc func registerNotificationCategories() {
         let notificationCenter = UNUserNotificationCenter.current()
 
+        // Capture the original delegate if it's not self
+        if notificationCenter.delegate !== self {
+            originalDelegate = notificationCenter.delegate
+        }
+
         // Set the plugin as the notification delegate
         notificationCenter.delegate = self
     }
@@ -199,30 +214,68 @@ extension BackgroundRunnerPlugin: UNUserNotificationCenterDelegate {
     public func userNotificationCenter(_ center: UNUserNotificationCenter,
                                        didReceive response: UNNotificationResponse,
                                        withCompletionHandler completionHandler: @escaping () -> Void) {
+        let userInfo = response.notification.request.content.userInfo
+
+        if isBackgroundRunnerNotification(userInfo) {
+            handleBackgroundRunnerNotification(response, completionHandler: completionHandler)
+        } else {
+            forwardToOriginalDelegate(center, didReceive: response, withCompletionHandler: completionHandler)
+        }
+    }
+
+    // This is needed to present notifications when the app is in the foreground
+    public func userNotificationCenter(_ center: UNUserNotificationCenter,
+                                       willPresent notification: UNNotification,
+                                       withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
+        let userInfo = notification.request.content.userInfo
+
+        if isBackgroundRunnerNotification(userInfo) {
+            handleBackgroundRunnerPresentation(completionHandler: completionHandler)
+        } else {
+            forwardToOriginalDelegate(center, willPresent: notification, withCompletionHandler: completionHandler)
+        }
+    }
+
+    // MARK: - Helper Methods
+
+    private func isBackgroundRunnerNotification(_ userInfo: [AnyHashable: Any]) -> Bool {
+        return (userInfo["source"] as? String) == "capacitor-background-runner"
+    }
+
+    private func handleBackgroundRunnerNotification(_ response: UNNotificationResponse, completionHandler: @escaping () -> Void) {
         let actionTypeId = response.notification.request.content.categoryIdentifier
         let notificationId = Int(response.notification.request.identifier) ?? -1
 
-        // Create event data
         let eventData: [String: Any] = [
             "actionTypeId": actionTypeId,
             "notificationId": notificationId
         ]
 
-        // Notify listeners with the action data - the 'true' parameter is for retaining the event
         notifyListeners("backgroundRunnerNotificationReceived", data: eventData, retainUntilConsumed: true)
-
         completionHandler()
     }
 
-    // This is needed to present notifications when the app is in the foreground
-    public func userNotificationCenter(_ center: UNUserNotificationCenter,
-                                       willPresent notification: UNNotification,
-                                       withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
-        // Show the notification even when the app is in foreground
+    private func forwardToOriginalDelegate(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
+        if let originalDelegate = originalDelegate, originalDelegate.responds(to: #selector(userNotificationCenter(_:didReceive:withCompletionHandler:))) {
+            originalDelegate.userNotificationCenter?(center, didReceive: response, withCompletionHandler: completionHandler)
+        } else {
+            completionHandler()
+        }
+    }
+
+    private func handleBackgroundRunnerPresentation(completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
         if #available(iOS 14.0, *) {
             completionHandler([.banner, .sound, .badge])
         } else {
             completionHandler([.alert, .sound, .badge])
         }
     }
+
+    private func forwardToOriginalDelegate(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
+        if let originalDelegate = originalDelegate, originalDelegate.responds(to: #selector(userNotificationCenter(_:willPresent:withCompletionHandler:))) {
+            originalDelegate.userNotificationCenter?(center, willPresent: notification, withCompletionHandler: completionHandler)
+        } else {
+            handleBackgroundRunnerPresentation(completionHandler: completionHandler)
+        }
+    }
 }

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

@@ -1,11 +1,17 @@
 import Foundation
 
+#if canImport(RunnerEngine)
+import RunnerEngine
+#endif
+
 extension Context {
     public func setupCapacitorAPI() {
         jsContext.setObject(CapacitorKVStore.self, forKeyedSubscript: "CapacitorKV" as NSString)
-        jsContext.setObject(CapacitorGeolocation(context: self), forKeyedSubscript: "CapacitorGeolocation" as NSString)
+        jsContext.setObject(
+            CapacitorGeolocation(context: self), forKeyedSubscript: "CapacitorGeolocation" as NSString)
         jsContext.setObject(CapacitorWatch(), forKeyedSubscript: "CapacitorWatch" as NSString)
-        jsContext.setObject(CapacitorNotifications.self, forKeyedSubscript: "CapacitorNotifications" as NSString)
+        jsContext.setObject(
+            CapacitorNotifications.self, forKeyedSubscript: "CapacitorNotifications" as NSString)
         jsContext.setObject(CapacitorDevice(), forKeyedSubscript: "CapacitorDevice" as NSString)
         jsContext.setObject(CapacitorApp.self, forKeyedSubscript: "CapacitorApp" as NSString)
     }

package/ios/{Plugin → Sources}/RunnerEngine/Context.swift

@@ -3,7 +3,7 @@ import JavaScriptCore
 
 public class Context {
     let name: String
-    let jsContext: JSContext
+    public let jsContext: JSContext
 
     private var eventListeners = [String: JSValue]()
     private var timers = [Int: Timer]()

package/ios/{Plugin → Sources}/RunnerEngine/JSCrypto.swift

@@ -13,17 +13,17 @@ class JSCrypto: NSObject, JSCryptoExports {
         var rnd = [UInt8](repeating: 0, count: size)
         _ = SecRandomCopyBytes(kSecRandomDefault, size, &rnd)
 
-        if arr.toArray() as? [UInt8] != nil {
+        if arr.toArray() is [UInt8] {
             for i in 0...(size - 1) {
                 arr.setObject(rnd[i], atIndexedSubscript: i)
             }
         }
-        if arr.toArray() as? [UInt16] != nil {
+        if arr.toArray() is [UInt16] {
             for i in 0...(size - 1) {
                 arr.setObject(UInt16(rnd[i]), atIndexedSubscript: i)
             }
         }
-        if arr.toArray() as? [UInt32] != nil {
+        if arr.toArray() is [UInt32] {
             for i in 0...(size - 1) {
                 arr.setObject(UInt32(rnd[i]), forKeyedSubscript: i)
             }

package/ios/{Plugin → Sources}/RunnerEngine/JSError.swift

@@ -27,7 +27,7 @@ import JavaScriptCore
         self.cause = nil
     }
 
-    func toString() -> String {
+    public func toString() -> String {
         return message
     }
 }

package/ios/{Plugin → Sources}/RunnerEngine/Runner.swift

@@ -12,7 +12,7 @@ public class Runner {
         runLoop = RunLoop.current
     }
 
-    func createContext(name: String) throws -> Context {
+    public func createContext(name: String) throws -> Context {
         return try Context(vm: machine, contextName: name, runLoop: runLoop)
     }
 }

package/ios/Tests/CapacitorBackgroundRunnerTests/CapacitorBackgroundRunnerTests.swift

@@ -0,0 +1,21 @@
+import Testing
+@testable import CapacitorBackgroundRunner
+@testable import RunnerEngine
+
+@Test func testKeyValueAPI() async throws {
+    let runner = Runner()
+    let context = try runner.createContext(name: "io.backgroundrunner.testkv")
+    context.setupCapacitorAPI()
+
+    _ = try context.execute(code: "CapacitorKV.set('test', 'hello world');")
+
+    let value = try context.execute(code: "CapacitorKV.get('test');")
+
+    #expect(value?.toDictionary()?["value"] as? String == "hello world")
+
+    _ = try context.execute(code: "CapacitorKV.remove('test');")
+
+    let nullValue = try context.execute(code: "CapacitorKV.get('test');")
+
+    #expect(nullValue?.isNull ?? false)
+}