expo-background-fetch 13.1.1 → 13.1.2

package/CHANGELOG.md

@@ -10,6 +10,12 @@
 
 ### 💡 Others
 
+## 13.1.2 — 2025-04-11
+
+### 💡 Others
+
+- Added warning about Background Fetch not being supported in Expo Go ([#36063](https://github.com/expo/expo/pull/36063) by [@chrfalch](https://github.com/chrfalch))
+
 ## 13.1.1 — 2025-04-09
 
 _This version does not introduce any user-facing changes._

package/android/build.gradle

@@ -4,13 +4,13 @@ plugins {
 }
 
 group = 'host.exp.exponent'
-version = '13.1.1'
+version = '13.1.2'
 
 android {
   namespace "expo.modules.backgroundfetch"
   defaultConfig {
     versionCode 23
-    versionName "13.1.1"
+    versionName "13.1.2"
     consumerProguardFiles("proguard-rules.pro")
   }
 }

package/build/BackgroundFetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BackgroundFetch.d.ts","sourceRoot":"","sources":["../src/BackgroundFetch.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAejC;;;;;GAKG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAO5E;AAGD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,uBAAuB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQpF;AAGD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAYf;AAGD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzE;AAED,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"BackgroundFetch.d.ts","sourceRoot":"","sources":["../src/BackgroundFetch.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAgCjC;;;;;GAKG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAO5E;AAGD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,uBAAuB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQpF;AAGD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAaf;AAGD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzE;AAED,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,CAAC"}

package/build/BackgroundFetch.js

@@ -1,3 +1,4 @@
+import { isRunningInExpoGo } from 'expo';
 import { Platform, UnavailabilityError } from 'expo-modules-core';
 import * as TaskManager from 'expo-task-manager';
 import { BackgroundFetchResult, BackgroundFetchStatus, } from './BackgroundFetch.types';
@@ -9,6 +10,20 @@ const showDeprecationWarning = () => {
         console.warn('expo-background-fetch: This library is deprecated. Use expo-background-task instead.');
     }
 };
+let warnedAboutExpoGo = false;
+function _validate(taskName) {
+    if (isRunningInExpoGo()) {
+        if (!warnedAboutExpoGo) {
+            const message = '`Background Fetch` functionality is not available in Expo Go:\n' +
+                'Please use a development build to avoid limitations. Learn more: https://expo.fyi/dev-client.';
+            console.warn(message);
+            warnedAboutExpoGo = true;
+        }
+    }
+    if (!taskName || typeof taskName !== 'string') {
+        throw new TypeError('`taskName` must be a non-empty string.');
+    }
+}
 // @needsAudit
 /**
  * Gets a status of background fetch.
@@ -78,6 +93,7 @@ export async function registerTaskAsync(taskName, options = {}) {
     if (!TaskManager.isTaskDefined(taskName)) {
         throw new Error(`Task '${taskName}' is not defined. You must define a task using TaskManager.defineTask before registering.`);
     }
+    _validate(taskName);
     await ExpoBackgroundFetch.registerTaskAsync(taskName, options);
 }
 // @needsAudit
@@ -93,6 +109,7 @@ export async function unregisterTaskAsync(taskName) {
     if (!ExpoBackgroundFetch.unregisterTaskAsync) {
         throw new UnavailabilityError('BackgroundFetch', 'unregisterTaskAsync');
     }
+    _validate(taskName);
     await ExpoBackgroundFetch.unregisterTaskAsync(taskName);
 }
 export { BackgroundFetchResult, BackgroundFetchStatus };

package/build/BackgroundFetch.js.map

@@ -1 +1 @@
-{"version":3,"file":"BackgroundFetch.js","sourceRoot":"","sources":["../src/BackgroundFetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAEL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,mBAAmB,MAAM,uBAAuB,CAAC;AAExD,IAAI,yBAAyB,GAAG,KAAK,CAAC;AAEtC,MAAM,sBAAsB,GAAG,GAAG,EAAE;IAClC,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAC/B,yBAAyB,GAAG,IAAI,CAAC;QACjC,OAAO,CAAC,IAAI,CACV,sFAAsF,CACvF,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF,cAAc;AACd;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,sBAAsB,EAAE,CAAC;IAEzB,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,qBAAqB,CAAC,SAAS,CAAC;IACzC,CAAC;IACD,OAAO,mBAAmB,CAAC,cAAc,EAAE,CAAC;AAC9C,CAAC;AAED,cAAc;AACd;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,eAAuB;IACnE,sBAAsB,EAAE,CAAC;IAEzB,IAAI,CAAC,mBAAmB,CAAC,uBAAuB,EAAE,CAAC;QACjD,OAAO;IACT,CAAC;IACD,WAAW;IACX,MAAM,mBAAmB,CAAC,uBAAuB,CAAC,eAAe,CAAC,CAAC;AACrE,CAAC;AAED,cAAc;AACd;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAgB,EAChB,UAAkC,EAAE;IAEpC,sBAAsB,EAAE,CAAC;IAEzB,IAAI,CAAC,mBAAmB,CAAC,iBAAiB,EAAE,CAAC;QAC3C,MAAM,IAAI,mBAAmB,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,SAAS,QAAQ,2FAA2F,CAC7G,CAAC;IACJ,CAAC;IACD,MAAM,mBAAmB,CAAC,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACjE,CAAC;AAED,cAAc;AACd;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,QAAgB;IACxD,sBAAsB,EAAE,CAAC;IAEzB,IAAI,CAAC,mBAAmB,CAAC,mBAAmB,EAAE,CAAC;QAC7C,MAAM,IAAI,mBAAmB,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,mBAAmB,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAC1D,CAAC;AAED,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAA0B,CAAC","sourcesContent":["import { Platform, UnavailabilityError } from 'expo-modules-core';\nimport * as TaskManager from 'expo-task-manager';\n\nimport {\n  BackgroundFetchOptions,\n  BackgroundFetchResult,\n  BackgroundFetchStatus,\n} from './BackgroundFetch.types';\nimport ExpoBackgroundFetch from './ExpoBackgroundFetch';\n\nlet didShowDeprecationWarning = false;\n\nconst showDeprecationWarning = () => {\n  if (!didShowDeprecationWarning) {\n    didShowDeprecationWarning = true;\n    console.warn(\n      'expo-background-fetch: This library is deprecated. Use expo-background-task instead.'\n    );\n  }\n};\n\n// @needsAudit\n/**\n * Gets a status of background fetch.\n * @return Returns a promise which fulfils with one of `BackgroundFetchStatus` enum values.\n * @deprecated Use [`getStatusAsync()`](./background-task/#backgroundtaskgetstatusasync) from `expo-background-task`\n * instead. The `expo-background-fetch` package has been deprecated.\n */\nexport async function getStatusAsync(): Promise<BackgroundFetchStatus | null> {\n  showDeprecationWarning();\n\n  if (Platform.OS === 'android') {\n    return BackgroundFetchStatus.Available;\n  }\n  return ExpoBackgroundFetch.getStatusAsync();\n}\n\n// @needsAudit\n/**\n * Sets the minimum number of seconds that must elapse before another background fetch can be\n * initiated. This value is advisory only and does not indicate the exact amount of time expected\n * between fetch operations.\n *\n * > This method doesn't take any effect on Android. It is a global value which means that it can\n * overwrite settings from another application opened through Expo Go.\n *\n * @param minimumInterval Number of seconds that must elapse before another background fetch can be called.\n * @return A promise which fulfils once the minimum interval is set.\n * @deprecated Use the [`registerTaskAsync()`](./background-task#backgroundtaskregistertaskasynctaskname-options) method\n * from expo-background-task package, and specify [`BackgroundTaskOptions`](./background-task/#backgroundtaskoptions)\n * argument instead, when setting task interval time.\n */\nexport async function setMinimumIntervalAsync(minimumInterval: number): Promise<void> {\n  showDeprecationWarning();\n\n  if (!ExpoBackgroundFetch.setMinimumIntervalAsync) {\n    return;\n  }\n  // iOS only\n  await ExpoBackgroundFetch.setMinimumIntervalAsync(minimumInterval);\n}\n\n// @needsAudit\n/**\n * Registers background fetch task with 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/#taskmanagerdefinetaskttaskname-taskexecutor)\n * for more details.\n * @param options An object containing the background fetch options.\n *\n * @example\n * ```ts\n * import * as BackgroundFetch from 'expo-background-fetch';\n * import * as TaskManager from 'expo-task-manager';\n *\n * TaskManager.defineTask(YOUR_TASK_NAME, () => {\n *   try {\n *     const receivedNewData = // do your background fetch here\n *     return receivedNewData ? BackgroundFetch.BackgroundFetchResult.NewData : BackgroundFetch.BackgroundFetchResult.NoData;\n *   } catch (error) {\n *     return BackgroundFetch.BackgroundFetchResult.Failed;\n *   }\n * });\n * ```\n * @deprecated Use [`registerTaskAsync()`](./background-task#backgroundtaskregistertaskasynctaskname-options) from `expo-background-task`\n * instead. The `expo-background-fetch` package has been deprecated.\n */\nexport async function registerTaskAsync(\n  taskName: string,\n  options: BackgroundFetchOptions = {}\n): Promise<void> {\n  showDeprecationWarning();\n\n  if (!ExpoBackgroundFetch.registerTaskAsync) {\n    throw new UnavailabilityError('BackgroundFetch', '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  await ExpoBackgroundFetch.registerTaskAsync(taskName, options);\n}\n\n// @needsAudit\n/**\n * Unregisters background fetch 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 * @deprecated Use [`unregisterTaskAsync()`](./background-task/#backgroundtaskunregistertaskasynctaskname) from `expo-background-task`\n * instead. The `expo-background-fetch` package has been deprecated.\n */\nexport async function unregisterTaskAsync(taskName: string): Promise<void> {\n  showDeprecationWarning();\n\n  if (!ExpoBackgroundFetch.unregisterTaskAsync) {\n    throw new UnavailabilityError('BackgroundFetch', 'unregisterTaskAsync');\n  }\n  await ExpoBackgroundFetch.unregisterTaskAsync(taskName);\n}\n\nexport { BackgroundFetchResult, BackgroundFetchStatus, BackgroundFetchOptions };\n"]}
+{"version":3,"file":"BackgroundFetch.js","sourceRoot":"","sources":["../src/BackgroundFetch.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 {\n  BackgroundFetchOptions,\n  BackgroundFetchResult,\n  BackgroundFetchStatus,\n} from './BackgroundFetch.types';\nimport ExpoBackgroundFetch from './ExpoBackgroundFetch';\n\nlet didShowDeprecationWarning = false;\n\nconst showDeprecationWarning = () => {\n  if (!didShowDeprecationWarning) {\n    didShowDeprecationWarning = true;\n    console.warn(\n      'expo-background-fetch: This library is deprecated. Use expo-background-task instead.'\n    );\n  }\n};\n\nlet warnedAboutExpoGo = false;\n\nfunction _validate(taskName: unknown) {\n  if (isRunningInExpoGo()) {\n    if (!warnedAboutExpoGo) {\n      const message =\n        '`Background Fetch` functionality is not available in Expo Go:\\n' +\n        'Please use a development build to avoid limitations. 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 * Gets a status of background fetch.\n * @return Returns a promise which fulfils with one of `BackgroundFetchStatus` enum values.\n * @deprecated Use [`getStatusAsync()`](./background-task/#backgroundtaskgetstatusasync) from `expo-background-task`\n * instead. The `expo-background-fetch` package has been deprecated.\n */\nexport async function getStatusAsync(): Promise<BackgroundFetchStatus | null> {\n  showDeprecationWarning();\n\n  if (Platform.OS === 'android') {\n    return BackgroundFetchStatus.Available;\n  }\n  return ExpoBackgroundFetch.getStatusAsync();\n}\n\n// @needsAudit\n/**\n * Sets the minimum number of seconds that must elapse before another background fetch can be\n * initiated. This value is advisory only and does not indicate the exact amount of time expected\n * between fetch operations.\n *\n * > This method doesn't take any effect on Android. It is a global value which means that it can\n * overwrite settings from another application opened through Expo Go.\n *\n * @param minimumInterval Number of seconds that must elapse before another background fetch can be called.\n * @return A promise which fulfils once the minimum interval is set.\n * @deprecated Use the [`registerTaskAsync()`](./background-task#backgroundtaskregistertaskasynctaskname-options) method\n * from expo-background-task package, and specify [`BackgroundTaskOptions`](./background-task/#backgroundtaskoptions)\n * argument instead, when setting task interval time.\n */\nexport async function setMinimumIntervalAsync(minimumInterval: number): Promise<void> {\n  showDeprecationWarning();\n\n  if (!ExpoBackgroundFetch.setMinimumIntervalAsync) {\n    return;\n  }\n  // iOS only\n  await ExpoBackgroundFetch.setMinimumIntervalAsync(minimumInterval);\n}\n\n// @needsAudit\n/**\n * Registers background fetch task with 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/#taskmanagerdefinetaskttaskname-taskexecutor)\n * for more details.\n * @param options An object containing the background fetch options.\n *\n * @example\n * ```ts\n * import * as BackgroundFetch from 'expo-background-fetch';\n * import * as TaskManager from 'expo-task-manager';\n *\n * TaskManager.defineTask(YOUR_TASK_NAME, () => {\n *   try {\n *     const receivedNewData = // do your background fetch here\n *     return receivedNewData ? BackgroundFetch.BackgroundFetchResult.NewData : BackgroundFetch.BackgroundFetchResult.NoData;\n *   } catch (error) {\n *     return BackgroundFetch.BackgroundFetchResult.Failed;\n *   }\n * });\n * ```\n * @deprecated Use [`registerTaskAsync()`](./background-task#backgroundtaskregistertaskasynctaskname-options) from `expo-background-task`\n * instead. The `expo-background-fetch` package has been deprecated.\n */\nexport async function registerTaskAsync(\n  taskName: string,\n  options: BackgroundFetchOptions = {}\n): Promise<void> {\n  showDeprecationWarning();\n\n  if (!ExpoBackgroundFetch.registerTaskAsync) {\n    throw new UnavailabilityError('BackgroundFetch', '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  _validate(taskName);\n  await ExpoBackgroundFetch.registerTaskAsync(taskName, options);\n}\n\n// @needsAudit\n/**\n * Unregisters background fetch 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 * @deprecated Use [`unregisterTaskAsync()`](./background-task/#backgroundtaskunregistertaskasynctaskname) from `expo-background-task`\n * instead. The `expo-background-fetch` package has been deprecated.\n */\nexport async function unregisterTaskAsync(taskName: string): Promise<void> {\n  showDeprecationWarning();\n\n  if (!ExpoBackgroundFetch.unregisterTaskAsync) {\n    throw new UnavailabilityError('BackgroundFetch', 'unregisterTaskAsync');\n  }\n  _validate(taskName);\n  await ExpoBackgroundFetch.unregisterTaskAsync(taskName);\n}\n\nexport { BackgroundFetchResult, BackgroundFetchStatus, BackgroundFetchOptions };\n"]}

package/expo-module.config.json

@@ -8,7 +8,7 @@
     "publication": {
       "groupId": "host.exp.exponent",
       "artifactId": "expo.modules.backgroundfetch",
-      "version": "13.1.1",
+      "version": "13.1.2",
       "repository": "local-maven-repo"
     }
   }

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundfetch/{13.1.1/expo.modules.backgroundfetch-13.1.1.module → 13.1.2/expo.modules.backgroundfetch-13.1.2.module}

@@ -3,7 +3,7 @@
   "component": {
     "group": "host.exp.exponent",
     "module": "expo.modules.backgroundfetch",
-    "version": "13.1.1",
+    "version": "13.1.2",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -24,8 +24,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.backgroundfetch-13.1.1.aar",
-          "url": "expo.modules.backgroundfetch-13.1.1.aar",
+          "name": "expo.modules.backgroundfetch-13.1.2.aar",
+          "url": "expo.modules.backgroundfetch-13.1.2.aar",
           "size": 16359,
           "sha512": "a1efa7055b1171c498a0f77a67fc91792692ceffe007b135623dcfcad731281e862d90abafda7e481241817e211de8f30b8ee81e8b9d6d7f1da39b363688f224",
           "sha256": "fc11238742920dee7b2b3cc852d414c0d88175138f12c52f04611762f6e007a0",
@@ -53,8 +53,8 @@
       ],
       "files": [
         {
-          "name": "expo.modules.backgroundfetch-13.1.1.aar",
-          "url": "expo.modules.backgroundfetch-13.1.1.aar",
+          "name": "expo.modules.backgroundfetch-13.1.2.aar",
+          "url": "expo.modules.backgroundfetch-13.1.2.aar",
           "size": 16359,
           "sha512": "a1efa7055b1171c498a0f77a67fc91792692ceffe007b135623dcfcad731281e862d90abafda7e481241817e211de8f30b8ee81e8b9d6d7f1da39b363688f224",
           "sha256": "fc11238742920dee7b2b3cc852d414c0d88175138f12c52f04611762f6e007a0",
@@ -73,8 +73,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.backgroundfetch-13.1.1-sources.jar",
-          "url": "expo.modules.backgroundfetch-13.1.1-sources.jar",
+          "name": "expo.modules.backgroundfetch-13.1.2-sources.jar",
+          "url": "expo.modules.backgroundfetch-13.1.2-sources.jar",
           "size": 3461,
           "sha512": "20eebb9eba4239ad138aa98fd15fba3aacaea19dc834094ee88b0668211a95f233d99eaa1cab0531ccf779d6aa6d36bb583d85e35fdb30f180289ce29a43e578",
           "sha256": "3592ee09c21c9612c7b0c5664b5c258dd41010f4ae7c237e06a59448a75a3b52",

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundfetch/13.1.2/expo.modules.backgroundfetch-13.1.2.module.md5

@@ -0,0 +1 @@
+3ac259c4667d33f298b60fbcd880d6fb

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundfetch/13.1.2/expo.modules.backgroundfetch-13.1.2.module.sha1

@@ -0,0 +1 @@
+081b87a93edee3682c96c43620199c10cafed81d

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundfetch/13.1.2/expo.modules.backgroundfetch-13.1.2.module.sha256

@@ -0,0 +1 @@
+f227b7fedd3f4165e00a31ff7c6e71ca8931261ad8cd7c5ae550019a545d5639

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundfetch/13.1.2/expo.modules.backgroundfetch-13.1.2.module.sha512

@@ -0,0 +1 @@
+ca8b2c8a6f831f5119b9a0b4b18fe3c1945b608e40d3a74bab2d644b27e0ffbbe76b22984cad522a01ca8336e066ff1a785b9f3fe954e7a0d17f4d57a4a48896

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundfetch/{13.1.1/expo.modules.backgroundfetch-13.1.1.pom → 13.1.2/expo.modules.backgroundfetch-13.1.2.pom}

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

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundfetch/13.1.2/expo.modules.backgroundfetch-13.1.2.pom.md5

@@ -0,0 +1 @@
+929aeaa8145543ce8ba0103b79212e7c

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundfetch/13.1.2/expo.modules.backgroundfetch-13.1.2.pom.sha1

@@ -0,0 +1 @@
+5d12bc8f0f9e214c4ac7c7895e6cebc80286e91b

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundfetch/13.1.2/expo.modules.backgroundfetch-13.1.2.pom.sha256

@@ -0,0 +1 @@
+25c0d5352d038ec2d0034be7b6437095e3b32a6b49e22832027bf18c1f7aaf6f

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundfetch/13.1.2/expo.modules.backgroundfetch-13.1.2.pom.sha512

@@ -0,0 +1 @@
+281af48390b1897db7574379bd62bf2b778c08bda880e797c062787f12ad2a7933e21babc0ef4cc9e7732b7dc683487bc122c51e442c4feab6b37c68b67ded5d

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

@@ -3,11 +3,11 @@
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.backgroundfetch</artifactId>
   <versioning>
-    <latest>13.1.1</latest>
-    <release>13.1.1</release>
+    <latest>13.1.2</latest>
+    <release>13.1.2</release>
     <versions>
-      <version>13.1.1</version>
+      <version>13.1.2</version>
     </versions>
-    <lastUpdated>20250409202821</lastUpdated>
+    <lastUpdated>20250411043200</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-0a4b12b464cf1e2d97269fd6f220c440
+1d1153a5729357ad8f9e772856949317

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

@@ -1 +1 @@
-be46c4747fc9af6b39fe70a785a6cbe3a475891b
+00c5a2afe77e230814818e9cec747ef40686fb87

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

@@ -1 +1 @@
-dec2df4033461cce3f13f44d2e89f50addfe91d529929fadc1724bc6d8ff9d05
+b70ffd552875d2929aa3104f4c21f97856bb841c976f1dd0e3337eed42b34997

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

@@ -1 +1 @@
-f7a521719e3cd3ea4833b1b4aade801a2f5e3d88d7d96a4b64f470ba699aafa55d7cbeee709c5bfdef605def2bb89b017f150af585da8d2f70cd95ecdc8c572a
+76ff6e41afd212cabcdeebf10456721c9ecfa1798bfdfcd317634f6d63b4941e5f34d1b3517dfaa7b8a830a59edaf5f296b68fdf2687999fee0bff245c25898a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-background-fetch",
-  "version": "13.1.1",
+  "version": "13.1.2",
   "description": "Expo universal module for BackgroundFetch API",
   "main": "build/BackgroundFetch.js",
   "types": "build/BackgroundFetch.d.ts",
@@ -33,7 +33,7 @@
   "license": "MIT",
   "homepage": "https://docs.expo.dev/versions/latest/sdk/background-fetch/",
   "dependencies": {
-    "expo-task-manager": "~13.1.1"
+    "expo-task-manager": "~13.1.2"
   },
   "devDependencies": {
     "expo-module-scripts": "^4.1.1"
@@ -41,5 +41,5 @@
   "peerDependencies": {
     "expo": "*"
   },
-  "gitHead": "1914bb35d23af23078da37e70988261844436505"
+  "gitHead": "c81263062bf24ad09e51e019f1d7dc29fa651c55"
 }

package/src/BackgroundFetch.ts

@@ -1,3 +1,4 @@
+import { isRunningInExpoGo } from 'expo';
 import { Platform, UnavailabilityError } from 'expo-modules-core';
 import * as TaskManager from 'expo-task-manager';
 
@@ -19,6 +20,23 @@ const showDeprecationWarning = () => {
   }
 };
 
+let warnedAboutExpoGo = false;
+
+function _validate(taskName: unknown) {
+  if (isRunningInExpoGo()) {
+    if (!warnedAboutExpoGo) {
+      const message =
+        '`Background Fetch` functionality is not available in Expo Go:\n' +
+        'Please use a development build to avoid limitations. Learn more: https://expo.fyi/dev-client.';
+      console.warn(message);
+      warnedAboutExpoGo = true;
+    }
+  }
+  if (!taskName || typeof taskName !== 'string') {
+    throw new TypeError('`taskName` must be a non-empty string.');
+  }
+}
+
 // @needsAudit
 /**
  * Gets a status of background fetch.
@@ -98,6 +116,7 @@ export async function registerTaskAsync(
       `Task '${taskName}' is not defined. You must define a task using TaskManager.defineTask before registering.`
     );
   }
+  _validate(taskName);
   await ExpoBackgroundFetch.registerTaskAsync(taskName, options);
 }
 
@@ -115,6 +134,7 @@ export async function unregisterTaskAsync(taskName: string): Promise<void> {
   if (!ExpoBackgroundFetch.unregisterTaskAsync) {
     throw new UnavailabilityError('BackgroundFetch', 'unregisterTaskAsync');
   }
+  _validate(taskName);
   await ExpoBackgroundFetch.unregisterTaskAsync(taskName);
 }
 

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundfetch/13.1.1/expo.modules.backgroundfetch-13.1.1.module.md5

@@ -1 +0,0 @@
-fa004d20e85e44fbaae7b75a3e304cd8

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundfetch/13.1.1/expo.modules.backgroundfetch-13.1.1.module.sha1

@@ -1 +0,0 @@
-a3a4629aad9485c6867228eaf782759360603ea0

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundfetch/13.1.1/expo.modules.backgroundfetch-13.1.1.module.sha256

@@ -1 +0,0 @@
-fba6e04580cb0af50fd4327a40c03b97bf1a3edae3acbea4c4d8324737ab4f4b

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundfetch/13.1.1/expo.modules.backgroundfetch-13.1.1.module.sha512

@@ -1 +0,0 @@
-47ec1d398aac0cdc7c7243ab0ecd46efadbbd5c6c9d10b67436d9d398e8f9b7995c137553bfa1c9d4a0bb27bf6d12756b505074c3eb654ac0b3745c2a5308f38

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundfetch/13.1.1/expo.modules.backgroundfetch-13.1.1.pom.md5

@@ -1 +0,0 @@
-806383a7f3c149ef8563fdca4622de6e

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundfetch/13.1.1/expo.modules.backgroundfetch-13.1.1.pom.sha1

@@ -1 +0,0 @@
-6c582a74497e540c1b203ae393a78aa26844331d

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundfetch/13.1.1/expo.modules.backgroundfetch-13.1.1.pom.sha256

@@ -1 +0,0 @@
-bab9f1961ed255a11570b7b3917238dd3bdc5c64118744faaad601dcc24b01e7

package/local-maven-repo/host/exp/exponent/expo.modules.backgroundfetch/13.1.1/expo.modules.backgroundfetch-13.1.1.pom.sha512

@@ -1 +0,0 @@
-af3434c05e51d33f25c586c389b1e41fbc72fe8fb8cb6dd640fa215b3edd83d7ef0e7b4a9997e9a091191a88d1b2972adaf278f81c8b7aa67c4cc76465bdf90c