expo-background-task 1.0.7 → 1.0.8

package/CHANGELOG.md

@@ -10,6 +10,16 @@
 
 ### 💡 Others
 
+## 1.0.8 — 2025-09-18
+
+### 🎉 New features
+
+- [iOS] Added support for task expiration handler on iOS. ([#39773](https://github.com/expo/expo/pull/39773) by [@chrfalch](https://github.com/chrfalch))
+
+### 🐛 Bug fixes
+
+- [iOS] Fixed timing issue where background task iOS handler was not registered when we try to schedule a task. ([#39769](https://github.com/expo/expo/pull/39769) by [@chrfalch](https://github.com/chrfalch))
+
 ## 1.0.7 — 2025-09-11
 
 _This version does not introduce any user-facing changes._

package/android/build.gradle

@@ -4,7 +4,7 @@ plugins {
 }
 
 group = 'host.exp.exponent'
-version = '1.0.7'
+version = '1.0.8'
 
 dependencies {
   implementation 'androidx.work:work-runtime-ktx:2.9.1'
@@ -15,7 +15,7 @@ android {
   namespace "expo.modules.backgroundtask"
   defaultConfig {
     versionCode 23
-    versionName "1.0.7"
+    versionName "1.0.8"
     consumerProguardFiles("proguard-rules.pro")
   }
 }

package/build/BackgroundTask.d.ts

@@ -48,5 +48,16 @@ export declare function unregisterTaskAsync(taskName: string): Promise<void>;
  * @returns A promise which fulfils when the task is triggered.
  */
 export declare function triggerTaskWorkerForTestingAsync(): Promise<boolean>;
+/**
+ * Adds a listener that is called when the background executor expires. On iOS, tasks can run
+ * for minutes, but the system can interrupt the process at any time. This listener is called
+ * when the system decides to stop the background tasks and should be used to clean up resources
+ * or save state. When the expiry handler is called, the main task runner is rescheduled automatically.
+ * @platform ios
+ * @return An object with a `remove` method to unsubscribe the listener.
+ */
+export declare function addExpirationListener(listener: () => void): {
+    remove: () => void;
+};
 export { BackgroundTaskStatus, BackgroundTaskResult, BackgroundTaskOptions, } from './BackgroundTask.types';
 //# sourceMappingURL=BackgroundTask.d.ts.map

package/build/BackgroundTask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BackgroundTask.d.ts","sourceRoot":"","sources":["../src/BackgroundTask.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAwBrF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QAAa,OAAO,CAAC,oBAAoB,CAQnE,CAAC;AAGF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAGD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASzE;AAGD;;;;;GAKG;AACH,wBAAsB,gCAAgC,IAAI,OAAO,CAAC,OAAO,CAAC,CAUzE;AAGD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"BackgroundTask.d.ts","sourceRoot":"","sources":["../src/BackgroundTask.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAwBrF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QAAa,OAAO,CAAC,oBAAoB,CAQnE,CAAC;AAGF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAGD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASzE;AAGD;;;;;GAKG;AACH,wBAAsB,gCAAgC,IAAI,OAAO,CAAC,OAAO,CAAC,CAUzE;AAGD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG;IAAE,MAAM,EAAE,MAAM,IAAI,CAAA;CAAE,CAKlF;AAGD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC"}

package/build/BackgroundTask.js

@@ -121,6 +121,21 @@ export async function triggerTaskWorkerForTestingAsync() {
         return Promise.resolve(false);
     }
 }
+// @needsAudit
+/**
+ * Adds a listener that is called when the background executor expires. On iOS, tasks can run
+ * for minutes, but the system can interrupt the process at any time. This listener is called
+ * when the system decides to stop the background tasks and should be used to clean up resources
+ * or save state. When the expiry handler is called, the main task runner is rescheduled automatically.
+ * @platform ios
+ * @return An object with a `remove` method to unsubscribe the listener.
+ */
+export function addExpirationListener(listener) {
+    if (!ExpoBackgroundTaskModule.addListener) {
+        throw new UnavailabilityError('BackgroundTask', 'addListener');
+    }
+    return ExpoBackgroundTaskModule.addListener('onTasksExpired', listener);
+}
 // Export types
 export { BackgroundTaskStatus, BackgroundTaskResult, } from './BackgroundTask.types';
 //# sourceMappingURL=BackgroundTask.js.map

package/build/BackgroundTask.js.map

@@ -1 +1 @@
-{"version":3,"file":"BackgroundTask.js","sourceRoot":"","sources":["../src/BackgroundTask.ts"],"names":[],"mappings":"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","sourcesContent":["import { isRunningInExpoGo } from 'expo';\nimport { Platform, UnavailabilityError } from 'expo-modules-core';\nimport * as TaskManager from 'expo-task-manager';\n\nimport { BackgroundTaskOptions, BackgroundTaskStatus } from './BackgroundTask.types';\nimport ExpoBackgroundTaskModule from './ExpoBackgroundTaskModule';\n\n// Flag to warn about running on Apple simulator\nlet warnAboutRunningOniOSSimulator = false;\n\nlet warnedAboutExpoGo = false;\n\nfunction _validate(taskName: unknown) {\n  if (isRunningInExpoGo()) {\n    if (!warnedAboutExpoGo) {\n      const message =\n        '`Background Task` functionality is not available in Expo Go:\\n' +\n        'You can use this API and any others in a development build. Learn more: https://expo.fyi/dev-client.';\n      console.warn(message);\n      warnedAboutExpoGo = true;\n    }\n  }\n  if (!taskName || typeof taskName !== 'string') {\n    throw new TypeError('`taskName` must be a non-empty string.');\n  }\n}\n\n// @needsAudit\n/**\n * Returns the status for the Background Task API. On web, it always returns `BackgroundTaskStatus.Restricted`,\n * while on native platforms it returns `BackgroundTaskStatus.Available`.\n *\n * @returns A BackgroundTaskStatus enum value or `null` if not available.\n */\nexport const getStatusAsync = async (): Promise<BackgroundTaskStatus> => {\n  if (!ExpoBackgroundTaskModule.getStatusAsync) {\n    throw new UnavailabilityError('BackgroundTask', 'getStatusAsync');\n  }\n\n  return isRunningInExpoGo()\n    ? BackgroundTaskStatus.Restricted\n    : ExpoBackgroundTaskModule.getStatusAsync();\n};\n\n// @needsAudit\n/**\n * Registers a background task with the given name. Registered tasks are saved in persistent storage and restored once the app is initialized.\n * @param taskName Name of the task to register. The task needs to be defined first - see [`TaskManager.defineTask`](task-manager/#taskmanagerdefinetasktaskname-taskexecutor)\n * for more details.\n * @param options An object containing the background task options.\n *\n * @example\n * ```ts\n * import * as TaskManager from 'expo-task-manager';\n *\n * // Register the task outside of the component\n * TaskManager.defineTask(BACKGROUND_TASK_IDENTIFIER, () => {\n *   try {\n *     await AsyncStorage.setItem(LAST_TASK_DATE_KEY, Date.now().toString());\n *   } catch (error) {\n *     console.error('Failed to save the last fetch date', error);\n *     return BackgroundTaskResult.Failed;\n *   }\n *   return BackgroundTaskResult.Success;\n * });\n * ```\n *\n * You can now use the `registerTaskAsync` function to register the task:\n *\n * ```ts\n * BackgroundTask.registerTaskAsync(BACKGROUND_TASK_IDENTIFIER, {});\n * ```\n */\nexport async function registerTaskAsync(\n  taskName: string,\n  options: BackgroundTaskOptions = {}\n): Promise<void> {\n  if (!ExpoBackgroundTaskModule.registerTaskAsync) {\n    throw new UnavailabilityError('BackgroundTask', 'registerTaskAsync');\n  }\n  if (!TaskManager.isTaskDefined(taskName)) {\n    throw new Error(\n      `Task '${taskName}' is not defined. You must define a task using TaskManager.defineTask before registering.`\n    );\n  }\n\n  if ((await ExpoBackgroundTaskModule.getStatusAsync()) === BackgroundTaskStatus.Restricted) {\n    if (!warnAboutRunningOniOSSimulator) {\n      const message =\n        Platform.OS === 'ios'\n          ? `Background tasks are not supported on iOS simulators. Skipped registering task: ${taskName}.`\n          : `Background tasks are not available in the current environment. Skipped registering task: ${taskName}.`;\n      console.warn(message);\n      warnAboutRunningOniOSSimulator = true;\n    }\n    return;\n  }\n  _validate(taskName);\n  if (await TaskManager.isTaskRegisteredAsync(taskName)) {\n    return;\n  }\n  await ExpoBackgroundTaskModule.registerTaskAsync(taskName, options);\n}\n\n// @needsAudit\n/**\n * Unregisters a background task, so the application will no longer be executing this task.\n * @param taskName Name of the task to unregister.\n * @return A promise which fulfils when the task is fully unregistered.\n */\nexport async function unregisterTaskAsync(taskName: string): Promise<void> {\n  if (!ExpoBackgroundTaskModule.unregisterTaskAsync) {\n    throw new UnavailabilityError('BackgroundTask', 'unregisterTaskAsync');\n  }\n  _validate(taskName);\n  if (!(await TaskManager.isTaskRegisteredAsync(taskName))) {\n    return;\n  }\n  await ExpoBackgroundTaskModule.unregisterTaskAsync(taskName);\n}\n\n// @needsAudit\n/**\n * When in debug mode this function will trigger running the background tasks.\n * This function will only work for apps built in debug mode.\n * This method is only available in development mode. It will not work in production builds.\n * @returns A promise which fulfils when the task is triggered.\n */\nexport async function triggerTaskWorkerForTestingAsync(): Promise<boolean> {\n  if (__DEV__) {\n    if (!ExpoBackgroundTaskModule.triggerTaskWorkerForTestingAsync) {\n      throw new UnavailabilityError('BackgroundTask', 'triggerTaskWorkerForTestingAsync');\n    }\n    console.log('Calling triggerTaskWorkerForTestingAsync');\n    return await ExpoBackgroundTaskModule.triggerTaskWorkerForTestingAsync();\n  } else {\n    return Promise.resolve(false);\n  }\n}\n\n// Export types\nexport {\n  BackgroundTaskStatus,\n  BackgroundTaskResult,\n  BackgroundTaskOptions,\n} from './BackgroundTask.types';\n"]}
+{"version":3,"file":"BackgroundTask.js","sourceRoot":"","sources":["../src/BackgroundTask.ts"],"names":[],"mappings":"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","sourcesContent":["import { isRunningInExpoGo } from 'expo';\nimport { Platform, UnavailabilityError } from 'expo-modules-core';\nimport * as TaskManager from 'expo-task-manager';\n\nimport { BackgroundTaskOptions, BackgroundTaskStatus } from './BackgroundTask.types';\nimport ExpoBackgroundTaskModule from './ExpoBackgroundTaskModule';\n\n// Flag to warn about running on Apple simulator\nlet warnAboutRunningOniOSSimulator = false;\n\nlet warnedAboutExpoGo = false;\n\nfunction _validate(taskName: unknown) {\n  if (isRunningInExpoGo()) {\n    if (!warnedAboutExpoGo) {\n      const message =\n        '`Background Task` functionality is not available in Expo Go:\\n' +\n        'You can use this API and any others in a development build. Learn more: https://expo.fyi/dev-client.';\n      console.warn(message);\n      warnedAboutExpoGo = true;\n    }\n  }\n  if (!taskName || typeof taskName !== 'string') {\n    throw new TypeError('`taskName` must be a non-empty string.');\n  }\n}\n\n// @needsAudit\n/**\n * Returns the status for the Background Task API. On web, it always returns `BackgroundTaskStatus.Restricted`,\n * while on native platforms it returns `BackgroundTaskStatus.Available`.\n *\n * @returns A BackgroundTaskStatus enum value or `null` if not available.\n */\nexport const getStatusAsync = async (): Promise<BackgroundTaskStatus> => {\n  if (!ExpoBackgroundTaskModule.getStatusAsync) {\n    throw new UnavailabilityError('BackgroundTask', 'getStatusAsync');\n  }\n\n  return isRunningInExpoGo()\n    ? BackgroundTaskStatus.Restricted\n    : ExpoBackgroundTaskModule.getStatusAsync();\n};\n\n// @needsAudit\n/**\n * Registers a background task with the given name. Registered tasks are saved in persistent storage and restored once the app is initialized.\n * @param taskName Name of the task to register. The task needs to be defined first - see [`TaskManager.defineTask`](task-manager/#taskmanagerdefinetasktaskname-taskexecutor)\n * for more details.\n * @param options An object containing the background task options.\n *\n * @example\n * ```ts\n * import * as TaskManager from 'expo-task-manager';\n *\n * // Register the task outside of the component\n * TaskManager.defineTask(BACKGROUND_TASK_IDENTIFIER, () => {\n *   try {\n *     await AsyncStorage.setItem(LAST_TASK_DATE_KEY, Date.now().toString());\n *   } catch (error) {\n *     console.error('Failed to save the last fetch date', error);\n *     return BackgroundTaskResult.Failed;\n *   }\n *   return BackgroundTaskResult.Success;\n * });\n * ```\n *\n * You can now use the `registerTaskAsync` function to register the task:\n *\n * ```ts\n * BackgroundTask.registerTaskAsync(BACKGROUND_TASK_IDENTIFIER, {});\n * ```\n */\nexport async function registerTaskAsync(\n  taskName: string,\n  options: BackgroundTaskOptions = {}\n): Promise<void> {\n  if (!ExpoBackgroundTaskModule.registerTaskAsync) {\n    throw new UnavailabilityError('BackgroundTask', 'registerTaskAsync');\n  }\n  if (!TaskManager.isTaskDefined(taskName)) {\n    throw new Error(\n      `Task '${taskName}' is not defined. You must define a task using TaskManager.defineTask before registering.`\n    );\n  }\n\n  if ((await ExpoBackgroundTaskModule.getStatusAsync()) === BackgroundTaskStatus.Restricted) {\n    if (!warnAboutRunningOniOSSimulator) {\n      const message =\n        Platform.OS === 'ios'\n          ? `Background tasks are not supported on iOS simulators. Skipped registering task: ${taskName}.`\n          : `Background tasks are not available in the current environment. Skipped registering task: ${taskName}.`;\n      console.warn(message);\n      warnAboutRunningOniOSSimulator = true;\n    }\n    return;\n  }\n  _validate(taskName);\n  if (await TaskManager.isTaskRegisteredAsync(taskName)) {\n    return;\n  }\n  await ExpoBackgroundTaskModule.registerTaskAsync(taskName, options);\n}\n\n// @needsAudit\n/**\n * Unregisters a background task, so the application will no longer be executing this task.\n * @param taskName Name of the task to unregister.\n * @return A promise which fulfils when the task is fully unregistered.\n */\nexport async function unregisterTaskAsync(taskName: string): Promise<void> {\n  if (!ExpoBackgroundTaskModule.unregisterTaskAsync) {\n    throw new UnavailabilityError('BackgroundTask', 'unregisterTaskAsync');\n  }\n  _validate(taskName);\n  if (!(await TaskManager.isTaskRegisteredAsync(taskName))) {\n    return;\n  }\n  await ExpoBackgroundTaskModule.unregisterTaskAsync(taskName);\n}\n\n// @needsAudit\n/**\n * When in debug mode this function will trigger running the background tasks.\n * This function will only work for apps built in debug mode.\n * This method is only available in development mode. It will not work in production builds.\n * @returns A promise which fulfils when the task is triggered.\n */\nexport async function triggerTaskWorkerForTestingAsync(): Promise<boolean> {\n  if (__DEV__) {\n    if (!ExpoBackgroundTaskModule.triggerTaskWorkerForTestingAsync) {\n      throw new UnavailabilityError('BackgroundTask', 'triggerTaskWorkerForTestingAsync');\n    }\n    console.log('Calling triggerTaskWorkerForTestingAsync');\n    return await ExpoBackgroundTaskModule.triggerTaskWorkerForTestingAsync();\n  } else {\n    return Promise.resolve(false);\n  }\n}\n\n// @needsAudit\n/**\n * Adds a listener that is called when the background executor expires. On iOS, tasks can run\n * for minutes, but the system can interrupt the process at any time. This listener is called\n * when the system decides to stop the background tasks and should be used to clean up resources\n * or save state. When the expiry handler is called, the main task runner is rescheduled automatically.\n * @platform ios\n * @return An object with a `remove` method to unsubscribe the listener.\n */\nexport function addExpirationListener(listener: () => void): { remove: () => void } {\n  if (!ExpoBackgroundTaskModule.addListener) {\n    throw new UnavailabilityError('BackgroundTask', 'addListener');\n  }\n  return ExpoBackgroundTaskModule.addListener('onTasksExpired', listener);\n}\n\n// Export types\nexport {\n  BackgroundTaskStatus,\n  BackgroundTaskResult,\n  BackgroundTaskOptions,\n} from './BackgroundTask.types';\n"]}

package/build/ExpoBackgroundTaskModule.d.ts

@@ -1,6 +1,9 @@
 import { type NativeModule } from 'expo';
 import { BackgroundTaskOptions, BackgroundTaskStatus } from './BackgroundTask.types';
-declare class ExpoBackgroundTaskModule extends NativeModule {
+type ExpoBackgroundTaskEvents = {
+    onTasksExpired(): void;
+};
+declare class ExpoBackgroundTaskModule extends NativeModule<ExpoBackgroundTaskEvents> {
     getStatusAsync(): Promise<BackgroundTaskStatus>;
     registerTaskAsync(name: string, options: BackgroundTaskOptions): Promise<void>;
     unregisterTaskAsync(name: string): Promise<void>;

package/build/ExpoBackgroundTaskModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoBackgroundTaskModule.d.ts","sourceRoot":"","sources":["../src/ExpoBackgroundTaskModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AAE9D,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAErF,OAAO,OAAO,wBAAyB,SAAQ,YAAY;IACzD,cAAc,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAC/C,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9E,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAChD,gCAAgC,IAAI,OAAO,CAAC,OAAO,CAAC;CACrD;;AAED,wBAAmF"}
+{"version":3,"file":"ExpoBackgroundTaskModule.d.ts","sourceRoot":"","sources":["../src/ExpoBackgroundTaskModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AAE9D,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAErF,KAAK,wBAAwB,GAAG;IAC9B,cAAc,IAAI,IAAI,CAAC;CACxB,CAAC;AAEF,OAAO,OAAO,wBAAyB,SAAQ,YAAY,CAAC,wBAAwB,CAAC;IACnF,cAAc,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAC/C,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9E,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAChD,gCAAgC,IAAI,OAAO,CAAC,OAAO,CAAC;CACrD;;AAED,wBAAmF"}

package/build/ExpoBackgroundTaskModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoBackgroundTaskModule.js","sourceRoot":"","sources":["../src/ExpoBackgroundTaskModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAqB,MAAM,MAAM,CAAC;AAW9D,eAAe,mBAAmB,CAA2B,oBAAoB,CAAC,CAAC","sourcesContent":["import { requireNativeModule, type NativeModule } from 'expo';\n\nimport { BackgroundTaskOptions, BackgroundTaskStatus } from './BackgroundTask.types';\n\ndeclare class ExpoBackgroundTaskModule extends NativeModule {\n  getStatusAsync(): Promise<BackgroundTaskStatus>;\n  registerTaskAsync(name: string, options: BackgroundTaskOptions): Promise<void>;\n  unregisterTaskAsync(name: string): Promise<void>;\n  triggerTaskWorkerForTestingAsync(): Promise<boolean>;\n}\n\nexport default requireNativeModule<ExpoBackgroundTaskModule>('ExpoBackgroundTask');\n"]}
+{"version":3,"file":"ExpoBackgroundTaskModule.js","sourceRoot":"","sources":["../src/ExpoBackgroundTaskModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAqB,MAAM,MAAM,CAAC;AAe9D,eAAe,mBAAmB,CAA2B,oBAAoB,CAAC,CAAC","sourcesContent":["import { requireNativeModule, type NativeModule } from 'expo';\n\nimport { BackgroundTaskOptions, BackgroundTaskStatus } from './BackgroundTask.types';\n\ntype ExpoBackgroundTaskEvents = {\n  onTasksExpired(): void;\n};\n\ndeclare class ExpoBackgroundTaskModule extends NativeModule<ExpoBackgroundTaskEvents> {\n  getStatusAsync(): Promise<BackgroundTaskStatus>;\n  registerTaskAsync(name: string, options: BackgroundTaskOptions): Promise<void>;\n  unregisterTaskAsync(name: string): Promise<void>;\n  triggerTaskWorkerForTestingAsync(): Promise<boolean>;\n}\n\nexport default requireNativeModule<ExpoBackgroundTaskModule>('ExpoBackgroundTask');\n"]}

package/expo-module.config.json

@@ -9,7 +9,7 @@
     "publication": {
       "groupId": "host.exp.exponent",
       "artifactId": "expo.modules.backgroundtask",
-      "version": "1.0.7",
+      "version": "1.0.8",
       "repository": "local-maven-repo"
     }
   }

package/ios/BackgroundTaskAppDelegate.swift

@@ -13,7 +13,10 @@ public class BackgroundTaskAppDelegateSubscriber: ExpoAppDelegateSubscriber {
         // Set up expiration handler
         task.expirationHandler = { ()
           log.warn("Expo Background Tasks - task expired")
+          // Send message to Expo module
+          NotificationCenter.default.post(name: onTasksExpiredNotification, object: self, userInfo: [:])
           task.setTaskCompleted(success: false)
+          self.reschedule()
         }
 
         // Let's find the task service implementation and call the runTasks(withReason)
@@ -21,24 +24,30 @@ public class BackgroundTaskAppDelegateSubscriber: ExpoAppDelegateSubscriber {
           taskService.runTasks(with: EXTaskLaunchReasonBackgroundTask, userInfo: nil, completionHandler: { _ in
             // Mark iOS task as finished - this is important so that we can continue calling it
             task.setTaskCompleted(success: true)
-
-            // Reschedule
-            Task {
-              do {
-                log.debug("Background task successfully finished. Rescheduling")
-                try await BackgroundTaskScheduler.tryScheduleWorker()
-              } catch {
-                log.error("Could not reschedule the worker after task finished: \(error.localizedDescription)")
-              }
-            }
+            self.reschedule()
           })
         } else {
           task.setTaskCompleted(success: false)
           log.error("Expo Background Tasks: Could not find TaskService module")
         }
       }
+
+      // Signal to the scheduler that we're done.
+      BackgroundTaskScheduler.bgTaskSchedulerDidFinishRegister()
     }
 
     return true
   }
+
+  private func reschedule() {
+    // Reschedule
+    Task {
+      do {
+        log.debug("Background task successfully finished. Rescheduling")
+        try await BackgroundTaskScheduler.tryScheduleWorker()
+      } catch {
+        log.error("Could not reschedule the worker after task finished: \(error.localizedDescription)")
+      }
+    }
+  }
 }

package/ios/BackgroundTaskModule.swift

@@ -1,12 +1,30 @@
 // Copyright 2024-present 650 Industries. All rights reserved.
 import ExpoModulesCore
 
+private let onTasksExpired = "onTasksExpired"
+public let onTasksExpiredNotification = Notification.Name(onTasksExpired)
+
 public class BackgroundTaskModule: Module {
   private var taskManager: EXTaskManagerInterface?
 
   public func definition() -> ModuleDefinition {
     Name("ExpoBackgroundTask")
 
+    Events(onTasksExpired)
+
+    OnStartObserving(onTasksExpired) {
+      NotificationCenter.default.addObserver(
+        self,
+        selector: #selector(handleTasksExpiredNotification),
+        name: onTasksExpiredNotification,
+        object: nil)
+    }
+
+    OnStopObserving(onTasksExpired) {
+      // swiftlint:disable:next notification_center_detachment
+      NotificationCenter.default.removeObserver(self)
+    }
+
     OnCreate {
       taskManager = appContext?.legacyModule(implementing: EXTaskManagerInterface.self)
     }
@@ -29,7 +47,8 @@ public class BackgroundTaskModule: Module {
       }
 
       // Register task
-      taskManager.registerTask(withName: name, consumer: BackgroundTaskConsumer.self, options: options)
+      taskManager.registerTask(
+        withName: name, consumer: BackgroundTaskConsumer.self, options: options)
     }
 
     AsyncFunction("unregisterTaskAsync") { (name: String) in
@@ -51,8 +70,15 @@ public class BackgroundTaskModule: Module {
     }
 
     AsyncFunction("getStatusAsync") {
-      return BackgroundTaskScheduler.supportsBackgroundTasks() ?
-        BackgroundTaskStatus.available : .restricted
+      return BackgroundTaskScheduler.supportsBackgroundTasks()
+        ? BackgroundTaskStatus.available : .restricted
+    }
+  }
+
+  @objc func handleTasksExpiredNotification(_ notification: Notification) {
+    guard let url = notification.userInfo?["url"] as? URL else {
+      return
     }
+    self.sendEvent(onTasksExpired, [:])
   }
 }

package/ios/BackgroundTaskScheduler.swift

@@ -13,6 +13,52 @@ public class BackgroundTaskScheduler {
    */
   private static var intervalSeconds: TimeInterval = 12 * 60 * 60
 
+  /**
+   A one-time async gate that becomes ready after BGTaskScheduler registration finishes.
+   Multiple awaiters will be resumed when ready; subsequent awaiters return immediately.
+   */
+  private actor RegistrationGate {
+    private var ready: Bool = false
+    private var waiters: [CheckedContinuation<Void, Never>] = []
+
+    func awaitReady() async {
+      if ready { return }
+      await withCheckedContinuation { (continuation: CheckedContinuation<Void, Never>) in
+        if ready {
+          continuation.resume()
+        } else {
+          waiters.append(continuation)
+        }
+      }
+    }
+
+    func signalReady() {
+      guard !ready else { return }
+      ready = true
+      let continuations = waiters
+      waiters.removeAll()
+      for c in continuations {
+        c.resume()
+      }
+    }
+  }
+
+  /**
+   Registration gate that will only be signaled when the bgTaskSchedulerDidFinishRegister is called.
+   */
+  private static let registrationGate = RegistrationGate()
+
+  /**
+   Call from the BackgroundTaskAppDelegate after the call to BGTaskScheduler.shared.register has finished
+   so that we can hold back any tryScheduleWorker calls, especially the call to BGTaskScheduler.shared.submit
+   that will fail if called before the BGTaskScheduler has successfully registered its handler.
+   */
+  public static func bgTaskSchedulerDidFinishRegister() {
+    Task {
+      await registrationGate.signalReady()
+    }
+  }
+
   /**
    * Call when a task is registered to keep track of how many background task consumers we have
    */
@@ -50,6 +96,9 @@ public class BackgroundTaskScheduler {
       return
     }
 
+    // Wait until BGTaskScheduler registration has completed.
+    await registrationGate.awaitReady()
+
     // Stop existing tasks
     await stopWorker()
 

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/{1.0.7/expo.modules.backgroundtask-1.0.7.module → 1.0.8/expo.modules.backgroundtask-1.0.8.module}

@@ -3,7 +3,7 @@
   "component": {
     "group": "host.exp.exponent",
     "module": "expo.modules.backgroundtask",
-    "version": "1.0.7",
+    "version": "1.0.8",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -24,8 +24,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.backgroundtask-1.0.7.aar",
-          "url": "expo.modules.backgroundtask-1.0.7.aar",
+          "name": "expo.modules.backgroundtask-1.0.8.aar",
+          "url": "expo.modules.backgroundtask-1.0.8.aar",
           "size": 48252,
           "sha512": "5b5e60d520b379283db7486525e8801fa29159482770b20736ce592d9bc9d767c2aeedd2c365a1bc59723340a6064dbc1efc1bbbe64464109e0024b09720a70d",
           "sha256": "c4f03f70e9596c443a6029c83837e20038469065042559e921d389804a9a1b98",
@@ -64,8 +64,8 @@
       ],
       "files": [
         {
-          "name": "expo.modules.backgroundtask-1.0.7.aar",
-          "url": "expo.modules.backgroundtask-1.0.7.aar",
+          "name": "expo.modules.backgroundtask-1.0.8.aar",
+          "url": "expo.modules.backgroundtask-1.0.8.aar",
           "size": 48252,
           "sha512": "5b5e60d520b379283db7486525e8801fa29159482770b20736ce592d9bc9d767c2aeedd2c365a1bc59723340a6064dbc1efc1bbbe64464109e0024b09720a70d",
           "sha256": "c4f03f70e9596c443a6029c83837e20038469065042559e921d389804a9a1b98",
@@ -84,8 +84,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.backgroundtask-1.0.7-sources.jar",
-          "url": "expo.modules.backgroundtask-1.0.7-sources.jar",
+          "name": "expo.modules.backgroundtask-1.0.8-sources.jar",
+          "url": "expo.modules.backgroundtask-1.0.8-sources.jar",
           "size": 6850,
           "sha512": "0fc8a6188061d8818a320cd4c27e02e406cd4bf49aaef15fc95536365ff20a70d5e599ba86698b3b058fa676a7116f5d8530b0d0437eb90092e0d0593edb09bb",
           "sha256": "b8464c6ac3c14d1f3fed11e436deb971f7203a5389a08fda08951223923d2fca",

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/1.0.8/expo.modules.backgroundtask-1.0.8.module.md5

@@ -0,0 +1 @@
+c1c94bff79921a7bc8860744f17fa2a7

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/1.0.8/expo.modules.backgroundtask-1.0.8.module.sha1

@@ -0,0 +1 @@
+dc7da2fe977890d176e77a0f5875f260424c709d

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/1.0.8/expo.modules.backgroundtask-1.0.8.module.sha256

@@ -0,0 +1 @@
+542f501224cc35735103ee3bc89b4bba0cfbeac197cf2e574227c7b96d83a820

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/1.0.8/expo.modules.backgroundtask-1.0.8.module.sha512

@@ -0,0 +1 @@
+623b51cdad33abc86aba097aa6a5bca40bb12e9ed72e1c11c480b15d9a988523bfaf9eb11f01f9e81086975fcaf8dc70ca6161187354ac05e8205616131781ee

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/{1.0.7/expo.modules.backgroundtask-1.0.7.pom → 1.0.8/expo.modules.backgroundtask-1.0.8.pom}

@@ -9,7 +9,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.backgroundtask</artifactId>
-  <version>1.0.7</version>
+  <version>1.0.8</version>
   <packaging>aar</packaging>
   <name>expo.modules.backgroundtask</name>
   <url>https://github.com/expo/expo</url>

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/1.0.8/expo.modules.backgroundtask-1.0.8.pom.md5

@@ -0,0 +1 @@
+9b32b280b51bf8f68fa810142a03ce8f

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/1.0.8/expo.modules.backgroundtask-1.0.8.pom.sha1

@@ -0,0 +1 @@
+c44fcf6b0f79e620a5aba056f48280bc30633c06

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/1.0.8/expo.modules.backgroundtask-1.0.8.pom.sha256

@@ -0,0 +1 @@
+dfc4e72a1a499bb0676583deedc3b7932c94ccdcece276b0c5bd6cfa70ef9fa3

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/1.0.8/expo.modules.backgroundtask-1.0.8.pom.sha512

@@ -0,0 +1 @@
+43a0a0ad207f00f709262c53a75ebc7008bbb4a7ce08f98b5a6c67742dc561e28180ec5b1d9a041018eb3d22515b3d815be966e1e1e48d55de56c178caa13d23

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/maven-metadata.xml

@@ -3,11 +3,11 @@
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.backgroundtask</artifactId>
   <versioning>
-    <latest>1.0.7</latest>
-    <release>1.0.7</release>
+    <latest>1.0.8</latest>
+    <release>1.0.8</release>
     <versions>
-      <version>1.0.7</version>
+      <version>1.0.8</version>
     </versions>
-    <lastUpdated>20250911202148</lastUpdated>
+    <lastUpdated>20250918213206</lastUpdated>
   </versioning>
 </metadata>

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/maven-metadata.xml.md5

@@ -1 +1 @@
-d2eba3ff1fbbc499f4c8a9b66163d36c
+eda7ff3e888b83b1e9f7fd0e0a265b59

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/maven-metadata.xml.sha1

@@ -1 +1 @@
-ba27b549c28ffb6d2c40b96fd186dc1ced1a3aa3
+d0f0b61438b5a4511ea4327cbd8b4aca4239b3eb

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/maven-metadata.xml.sha256

@@ -1 +1 @@
-6b9f9f2454157b76c707c7b0fd33dc55ed3ecd5b17aee020ea43962ff36ca7cf
+a72fdc74f6d5af6ef96c952ae5c06c20aebc70bd1582fc63802c9ec6568d906c

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/maven-metadata.xml.sha512

@@ -1 +1 @@
-6e5268607cc81b69decddec402e2fa1b388c016b033508cee2d223913b97904c83a7772b45758846a0107830f03c00f2515b7ed0af639c0107ba2607c943187a
+dc0108fbcddcfb82815b96075716dc965a1f63974b3f37250067e9e715c71e103ab7b29feb117da17dc70680508f26e86fa379061304460f8348f8bae07d7ec6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-background-task",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Expo Android and iOS module for Background Task APIs",
   "main": "build/BackgroundTask.js",
   "types": "build/BackgroundTask.d.ts",
@@ -40,5 +40,5 @@
   "peerDependencies": {
     "expo": "*"
   },
-  "gitHead": "088e79428be97cf3ee11fc93e0e5a1fc1c8bea1e"
+  "gitHead": "0d9ae61f3dea2e2b854576859e5b50fca5503fc1"
 }

package/src/BackgroundTask.ts

@@ -138,6 +138,22 @@ export async function triggerTaskWorkerForTestingAsync(): Promise<boolean> {
   }
 }
 
+// @needsAudit
+/**
+ * Adds a listener that is called when the background executor expires. On iOS, tasks can run
+ * for minutes, but the system can interrupt the process at any time. This listener is called
+ * when the system decides to stop the background tasks and should be used to clean up resources
+ * or save state. When the expiry handler is called, the main task runner is rescheduled automatically.
+ * @platform ios
+ * @return An object with a `remove` method to unsubscribe the listener.
+ */
+export function addExpirationListener(listener: () => void): { remove: () => void } {
+  if (!ExpoBackgroundTaskModule.addListener) {
+    throw new UnavailabilityError('BackgroundTask', 'addListener');
+  }
+  return ExpoBackgroundTaskModule.addListener('onTasksExpired', listener);
+}
+
 // Export types
 export {
   BackgroundTaskStatus,

package/src/ExpoBackgroundTaskModule.ts

@@ -2,7 +2,11 @@ import { requireNativeModule, type NativeModule } from 'expo';
 
 import { BackgroundTaskOptions, BackgroundTaskStatus } from './BackgroundTask.types';
 
-declare class ExpoBackgroundTaskModule extends NativeModule {
+type ExpoBackgroundTaskEvents = {
+  onTasksExpired(): void;
+};
+
+declare class ExpoBackgroundTaskModule extends NativeModule<ExpoBackgroundTaskEvents> {
   getStatusAsync(): Promise<BackgroundTaskStatus>;
   registerTaskAsync(name: string, options: BackgroundTaskOptions): Promise<void>;
   unregisterTaskAsync(name: string): Promise<void>;

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/1.0.7/expo.modules.backgroundtask-1.0.7.module.md5

@@ -1 +0,0 @@
-845896d6a748f7290adcce426b70b65e

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/1.0.7/expo.modules.backgroundtask-1.0.7.module.sha1

@@ -1 +0,0 @@
-8e68d182be84478a9f0d069b56fc8daf155a155b

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/1.0.7/expo.modules.backgroundtask-1.0.7.module.sha256

@@ -1 +0,0 @@
-4fe0637ff751d0cfb961905d65b93dc53245253613c15193ec49fbe3ada4049d

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/1.0.7/expo.modules.backgroundtask-1.0.7.module.sha512

@@ -1 +0,0 @@
-cd78298fdf20d5a3f4cc1f18c23324f6ce60917bbb87d33a63470102de1ca4e5a143232c39b009ba93937e6893e3296f95a1dd9a861d425ed0010c15527158e4

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/1.0.7/expo.modules.backgroundtask-1.0.7.pom.md5

@@ -1 +0,0 @@
-28ea3d0eaebf97c36b622818cd6ea9f5

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/1.0.7/expo.modules.backgroundtask-1.0.7.pom.sha1

@@ -1 +0,0 @@
-485f45f0038a4cf310f6bbc55fd1e26448600e32

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/1.0.7/expo.modules.backgroundtask-1.0.7.pom.sha256

@@ -1 +0,0 @@
-cc0b38c4ebc65f6031bcb07677149d2692be02b08bbea0170693e67d78a8663d

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundtask/1.0.7/expo.modules.backgroundtask-1.0.7.pom.sha512

@@ -1 +0,0 @@
-bd2ab4b781b0c6833e79ca9196c3494d6488241b9564959084365de05ee74612e448ff8902fbcd5af43d6df4114427874cf44f8d4e2da8b53a6d2d7ac7d2d844