expo-screen-capture 7.1.5-canary-20250612-338ef55 → 7.2.0-canary-20250613-b29d676-1

package/CHANGELOG.md

@@ -6,6 +6,8 @@
 
 ### 🎉 New features
 
+- Implemented `useScreenshotListener` hook. ([#37411](https://github.com/expo/expo/pull/37411) by [@hryhoriiK97](https://github.com/hryhoriiK97))
+
 ### 🐛 Bug fixes
 
 - [Android] Fix permissions on Android 13.

package/android/build.gradle

@@ -4,13 +4,13 @@ plugins {
 }
 
 group = 'host.exp.exponent'
-version = '7.1.5-canary-20250612-338ef55'
+version = '7.2.0-canary-20250613-b29d676-1'
 
 android {
   namespace "expo.modules.screencapture"
   defaultConfig {
     versionCode 7
-    versionName '7.1.5-canary-20250612-338ef55'
+    versionName '7.2.0-canary-20250613-b29d676-1'
   }
 }
 

package/build/ScreenCapture.d.ts

@@ -74,6 +74,15 @@ export declare function addScreenshotListener(listener: () => void): EventSubscr
  * ```
  */
 export declare function removeScreenshotListener(subscription: EventSubscription): void;
+/**
+ * A React hook that listens for screenshots taken while the component is mounted.
+ *
+ * @param listener A function that will be called whenever a screenshot is detected.
+ *
+ * This hook automatically starts listening when the component mounts, and stops
+ * listening when the component unmounts.
+ */
+export declare function useScreenshotListener(listener: () => void): void;
 /**
  * Checks user's permissions for detecting when a screenshot is taken.
  * > Only Android requires additional permissions to detect screenshots. On iOS devices, this method will always resolve to a `granted` permission response.

package/build/ScreenCapture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScreenCapture.d.ts","sourceRoot":"","sources":["../src/ScreenCapture.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,kBAAkB,EAClB,gBAAgB,EAEhB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAU3B;;;;;GAKG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAEzD;AAGD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,yBAAyB,CAAC,GAAG,GAAE,MAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAStF;AAGD;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAAC,GAAG,GAAE,MAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CASpF;AAGD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,MAAkB,GAAG,IAAI,CAQrE;AAGD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,iBAAiB,CAE7E;AAGD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,iBAAiB,QAEvE;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAKvE;AAED;;;;KAIK;AACL,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAK3E;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,4JAGzB,CAAC;AASH,OAAO,EACL,iBAAiB,IAAI,YAAY,EACjC,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,GACtB,CAAC"}
+{"version":3,"file":"ScreenCapture.d.ts","sourceRoot":"","sources":["../src/ScreenCapture.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,kBAAkB,EAClB,gBAAgB,EAEhB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAU3B;;;;;GAKG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAEzD;AAGD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,yBAAyB,CAAC,GAAG,GAAE,MAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAStF;AAGD;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAAC,GAAG,GAAE,MAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CASpF;AAGD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,MAAkB,GAAG,IAAI,CAQrE;AAGD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,iBAAiB,CAE7E;AAGD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,iBAAiB,QAEvE;AAGD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,IAAI,QAQzD;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAKvE;AAED;;;;KAIK;AACL,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAK3E;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,4JAGzB,CAAC;AASH,OAAO,EACL,iBAAiB,IAAI,YAAY,EACjC,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,GACtB,CAAC"}

package/build/ScreenCapture.js

@@ -113,6 +113,23 @@ export function addScreenshotListener(listener) {
 export function removeScreenshotListener(subscription) {
     subscription.remove();
 }
+// @needsAudit
+/**
+ * A React hook that listens for screenshots taken while the component is mounted.
+ *
+ * @param listener A function that will be called whenever a screenshot is detected.
+ *
+ * This hook automatically starts listening when the component mounts, and stops
+ * listening when the component unmounts.
+ */
+export function useScreenshotListener(listener) {
+    useEffect(() => {
+        const subscription = addScreenshotListener(listener);
+        return () => {
+            removeScreenshotListener(subscription);
+        };
+    }, [listener]);
+}
 /**
  * Checks user's permissions for detecting when a screenshot is taken.
  * > Only Android requires additional permissions to detect screenshots. On iOS devices, this method will always resolve to a `granted` permission response.

package/build/ScreenCapture.js.map

@@ -1 +1 @@
-{"version":3,"file":"ScreenCapture.js","sourceRoot":"","sources":["../src/ScreenCapture.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  UnavailabilityError,\n  PermissionResponse,\n  PermissionStatus,\n  createPermissionHook,\n  PermissionHookOptions,\n  EventSubscription,\n} from 'expo-modules-core';\nimport { useEffect } from 'react';\n\nimport ExpoScreenCapture from './ExpoScreenCapture';\n\nconst activeTags: Set<string> = new Set();\n\nconst onScreenshotEventName = 'onScreenshot';\n\n// @needsAudit\n/**\n * Returns whether the Screen Capture API is available on the current device.\n *\n * @returns A promise that resolves to a `boolean` indicating whether the Screen Capture API is available on the current\n * device.\n */\nexport async function isAvailableAsync(): Promise<boolean> {\n  return !!ExpoScreenCapture.preventScreenCapture && !!ExpoScreenCapture.allowScreenCapture;\n}\n\n// @needsAudit\n/**\n * Prevents screenshots and screen recordings until `allowScreenCaptureAsync` is called or the app is restarted. If you are\n * already preventing screen capture, this method does nothing (unless you pass a new and unique `key`).\n *\n * > On iOS, this will only prevent screen recordings, and is only available on iOS 11 and newer. On older\n * iOS versions, this method does nothing.\n *\n * @param key Optional. If provided, this will help prevent multiple instances of the `preventScreenCaptureAsync`\n * and `allowScreenCaptureAsync` methods (and `usePreventScreenCapture` hook) from conflicting with each other.\n * When using multiple keys, you'll have to re-allow each one in order to re-enable screen capturing.\n *\n * @platform android\n * @platform ios 11+\n */\nexport async function preventScreenCaptureAsync(key: string = 'default'): Promise<void> {\n  if (!ExpoScreenCapture.preventScreenCapture) {\n    throw new UnavailabilityError('ScreenCapture', 'preventScreenCaptureAsync');\n  }\n\n  if (!activeTags.has(key)) {\n    activeTags.add(key);\n    await ExpoScreenCapture.preventScreenCapture();\n  }\n}\n\n// @needsAudit\n/**\n * Re-allows the user to screen record or screenshot your app. If you haven't called\n * `preventScreenCapture()` yet, this method does nothing.\n *\n * @param key This will prevent multiple instances of the `preventScreenCaptureAsync` and\n * `allowScreenCaptureAsync` methods from conflicting with each other. If provided, the value must\n * be the same as the key passed to `preventScreenCaptureAsync` in order to re-enable screen\n * capturing.\n */\nexport async function allowScreenCaptureAsync(key: string = 'default'): Promise<void> {\n  if (!ExpoScreenCapture.preventScreenCapture) {\n    throw new UnavailabilityError('ScreenCapture', 'allowScreenCaptureAsync');\n  }\n\n  activeTags.delete(key);\n  if (activeTags.size === 0) {\n    await ExpoScreenCapture.allowScreenCapture();\n  }\n}\n\n// @needsAudit\n/**\n * A React hook to prevent screen capturing for as long as the owner component is mounted.\n *\n * @param key If provided, this will prevent multiple instances of this hook or the\n * `preventScreenCaptureAsync` and `allowScreenCaptureAsync` methods from conflicting with each other.\n * This argument is useful if you have multiple active components using the `allowScreenCaptureAsync`\n * hook.\n */\nexport function usePreventScreenCapture(key: string = 'default'): void {\n  useEffect(() => {\n    preventScreenCaptureAsync(key);\n\n    return () => {\n      allowScreenCaptureAsync(key);\n    };\n  }, [key]);\n}\n\n// @needsAudit\n/**\n * Adds a listener that will fire whenever the user takes a screenshot while the app is foregrounded.\n *\n * Permission requirements for this method depend on your device’s Android version:\n * - **Before Android 13**: Requires `READ_EXTERNAL_STORAGE`.\n * - **Android 13**: Switches to `READ_MEDIA_IMAGES`.\n * - **Post-Android 13**: No additional permissions required.\n * You can request the appropriate permissions by using [`MediaLibrary.requestPermissionsAsync()`](./media-library/#medialibraryrequestpermissionsasync).\n *\n * @param listener The function that will be executed when the user takes a screenshot.\n * This function accepts no arguments.\n *\n * @return A `Subscription` object that you can use to unregister the listener, either by calling\n * `remove()` or passing it to `removeScreenshotListener`.\n */\nexport function addScreenshotListener(listener: () => void): EventSubscription {\n  return ExpoScreenCapture.addListener(onScreenshotEventName, listener);\n}\n\n// @needsAudit\n/**\n * Removes the subscription you provide, so that you are no longer listening for screenshots.\n * You can also call `remove()` on that `Subscription` object.\n *\n * @param subscription Subscription returned by `addScreenshotListener`.\n *\n * @example\n * ```ts\n * let mySubscription = addScreenshotListener(() => {\n *   console.log(\"You took a screenshot!\");\n * });\n * ...\n * mySubscription.remove();\n * // OR\n * removeScreenshotListener(mySubscription);\n * ```\n */\nexport function removeScreenshotListener(subscription: EventSubscription) {\n  subscription.remove();\n}\n\n/**\n * Checks user's permissions for detecting when a screenshot is taken.\n * > Only Android requires additional permissions to detect screenshots. On iOS devices, this method will always resolve to a `granted` permission response.\n * @return A promise that resolves to a [`PermissionResponse`](#permissionresponse) object.\n */\nexport async function getPermissionsAsync(): Promise<PermissionResponse> {\n  if (ExpoScreenCapture.getPermissionsAsync) {\n    return ExpoScreenCapture.getPermissionsAsync();\n  }\n  return defaultPermissionsResponse;\n}\n\n/**\n * Asks the user to grant permissions necessary for detecting when a screenshot is taken.\n * > Only Android requires additional permissions to detect screenshots. On iOS devices, this method will always resolve to a `granted` permission response.\n * @return A promise that resolves to a [`PermissionResponse`](#permissionresponse) object.\n * */\nexport async function requestPermissionsAsync(): Promise<PermissionResponse> {\n  if (ExpoScreenCapture.requestPermissionsAsync) {\n    return ExpoScreenCapture.requestPermissionsAsync();\n  }\n  return defaultPermissionsResponse;\n}\n\n/**\n * Check or request permissions necessary for detecting when a screenshot is taken.\n * This uses both [`requestPermissionsAsync`](#screencapturerequestpermissionsasync) and [`getPermissionsAsync`](#screencapturegetpermissionsasync) to interact with the permissions.\n *\n * @example\n * ```js\n * const [status, requestPermission] = ScreenCapture.usePermissions();\n * ```\n */\nexport const usePermissions = createPermissionHook({\n  getMethod: getPermissionsAsync,\n  requestMethod: requestPermissionsAsync,\n});\n\nconst defaultPermissionsResponse: PermissionResponse = {\n  granted: true,\n  expires: 'never',\n  canAskAgain: true,\n  status: PermissionStatus.GRANTED,\n};\n\nexport {\n  EventSubscription as Subscription,\n  PermissionResponse,\n  PermissionStatus,\n  PermissionHookOptions,\n};\n"]}
+{"version":3,"file":"ScreenCapture.js","sourceRoot":"","sources":["../src/ScreenCapture.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  UnavailabilityError,\n  PermissionResponse,\n  PermissionStatus,\n  createPermissionHook,\n  PermissionHookOptions,\n  EventSubscription,\n} from 'expo-modules-core';\nimport { useEffect } from 'react';\n\nimport ExpoScreenCapture from './ExpoScreenCapture';\n\nconst activeTags: Set<string> = new Set();\n\nconst onScreenshotEventName = 'onScreenshot';\n\n// @needsAudit\n/**\n * Returns whether the Screen Capture API is available on the current device.\n *\n * @returns A promise that resolves to a `boolean` indicating whether the Screen Capture API is available on the current\n * device.\n */\nexport async function isAvailableAsync(): Promise<boolean> {\n  return !!ExpoScreenCapture.preventScreenCapture && !!ExpoScreenCapture.allowScreenCapture;\n}\n\n// @needsAudit\n/**\n * Prevents screenshots and screen recordings until `allowScreenCaptureAsync` is called or the app is restarted. If you are\n * already preventing screen capture, this method does nothing (unless you pass a new and unique `key`).\n *\n * > On iOS, this will only prevent screen recordings, and is only available on iOS 11 and newer. On older\n * iOS versions, this method does nothing.\n *\n * @param key Optional. If provided, this will help prevent multiple instances of the `preventScreenCaptureAsync`\n * and `allowScreenCaptureAsync` methods (and `usePreventScreenCapture` hook) from conflicting with each other.\n * When using multiple keys, you'll have to re-allow each one in order to re-enable screen capturing.\n *\n * @platform android\n * @platform ios 11+\n */\nexport async function preventScreenCaptureAsync(key: string = 'default'): Promise<void> {\n  if (!ExpoScreenCapture.preventScreenCapture) {\n    throw new UnavailabilityError('ScreenCapture', 'preventScreenCaptureAsync');\n  }\n\n  if (!activeTags.has(key)) {\n    activeTags.add(key);\n    await ExpoScreenCapture.preventScreenCapture();\n  }\n}\n\n// @needsAudit\n/**\n * Re-allows the user to screen record or screenshot your app. If you haven't called\n * `preventScreenCapture()` yet, this method does nothing.\n *\n * @param key This will prevent multiple instances of the `preventScreenCaptureAsync` and\n * `allowScreenCaptureAsync` methods from conflicting with each other. If provided, the value must\n * be the same as the key passed to `preventScreenCaptureAsync` in order to re-enable screen\n * capturing.\n */\nexport async function allowScreenCaptureAsync(key: string = 'default'): Promise<void> {\n  if (!ExpoScreenCapture.preventScreenCapture) {\n    throw new UnavailabilityError('ScreenCapture', 'allowScreenCaptureAsync');\n  }\n\n  activeTags.delete(key);\n  if (activeTags.size === 0) {\n    await ExpoScreenCapture.allowScreenCapture();\n  }\n}\n\n// @needsAudit\n/**\n * A React hook to prevent screen capturing for as long as the owner component is mounted.\n *\n * @param key If provided, this will prevent multiple instances of this hook or the\n * `preventScreenCaptureAsync` and `allowScreenCaptureAsync` methods from conflicting with each other.\n * This argument is useful if you have multiple active components using the `allowScreenCaptureAsync`\n * hook.\n */\nexport function usePreventScreenCapture(key: string = 'default'): void {\n  useEffect(() => {\n    preventScreenCaptureAsync(key);\n\n    return () => {\n      allowScreenCaptureAsync(key);\n    };\n  }, [key]);\n}\n\n// @needsAudit\n/**\n * Adds a listener that will fire whenever the user takes a screenshot while the app is foregrounded.\n *\n * Permission requirements for this method depend on your device’s Android version:\n * - **Before Android 13**: Requires `READ_EXTERNAL_STORAGE`.\n * - **Android 13**: Switches to `READ_MEDIA_IMAGES`.\n * - **Post-Android 13**: No additional permissions required.\n * You can request the appropriate permissions by using [`MediaLibrary.requestPermissionsAsync()`](./media-library/#medialibraryrequestpermissionsasync).\n *\n * @param listener The function that will be executed when the user takes a screenshot.\n * This function accepts no arguments.\n *\n * @return A `Subscription` object that you can use to unregister the listener, either by calling\n * `remove()` or passing it to `removeScreenshotListener`.\n */\nexport function addScreenshotListener(listener: () => void): EventSubscription {\n  return ExpoScreenCapture.addListener(onScreenshotEventName, listener);\n}\n\n// @needsAudit\n/**\n * Removes the subscription you provide, so that you are no longer listening for screenshots.\n * You can also call `remove()` on that `Subscription` object.\n *\n * @param subscription Subscription returned by `addScreenshotListener`.\n *\n * @example\n * ```ts\n * let mySubscription = addScreenshotListener(() => {\n *   console.log(\"You took a screenshot!\");\n * });\n * ...\n * mySubscription.remove();\n * // OR\n * removeScreenshotListener(mySubscription);\n * ```\n */\nexport function removeScreenshotListener(subscription: EventSubscription) {\n  subscription.remove();\n}\n\n// @needsAudit\n/**\n * A React hook that listens for screenshots taken while the component is mounted.\n *\n * @param listener A function that will be called whenever a screenshot is detected.\n *\n * This hook automatically starts listening when the component mounts, and stops\n * listening when the component unmounts.\n */\nexport function useScreenshotListener(listener: () => void) {\n  useEffect(() => {\n    const subscription = addScreenshotListener(listener);\n\n    return () => {\n      removeScreenshotListener(subscription);\n    };\n  }, [listener]);\n}\n\n/**\n * Checks user's permissions for detecting when a screenshot is taken.\n * > Only Android requires additional permissions to detect screenshots. On iOS devices, this method will always resolve to a `granted` permission response.\n * @return A promise that resolves to a [`PermissionResponse`](#permissionresponse) object.\n */\nexport async function getPermissionsAsync(): Promise<PermissionResponse> {\n  if (ExpoScreenCapture.getPermissionsAsync) {\n    return ExpoScreenCapture.getPermissionsAsync();\n  }\n  return defaultPermissionsResponse;\n}\n\n/**\n * Asks the user to grant permissions necessary for detecting when a screenshot is taken.\n * > Only Android requires additional permissions to detect screenshots. On iOS devices, this method will always resolve to a `granted` permission response.\n * @return A promise that resolves to a [`PermissionResponse`](#permissionresponse) object.\n * */\nexport async function requestPermissionsAsync(): Promise<PermissionResponse> {\n  if (ExpoScreenCapture.requestPermissionsAsync) {\n    return ExpoScreenCapture.requestPermissionsAsync();\n  }\n  return defaultPermissionsResponse;\n}\n\n/**\n * Check or request permissions necessary for detecting when a screenshot is taken.\n * This uses both [`requestPermissionsAsync`](#screencapturerequestpermissionsasync) and [`getPermissionsAsync`](#screencapturegetpermissionsasync) to interact with the permissions.\n *\n * @example\n * ```js\n * const [status, requestPermission] = ScreenCapture.usePermissions();\n * ```\n */\nexport const usePermissions = createPermissionHook({\n  getMethod: getPermissionsAsync,\n  requestMethod: requestPermissionsAsync,\n});\n\nconst defaultPermissionsResponse: PermissionResponse = {\n  granted: true,\n  expires: 'never',\n  canAskAgain: true,\n  status: PermissionStatus.GRANTED,\n};\n\nexport {\n  EventSubscription as Subscription,\n  PermissionResponse,\n  PermissionStatus,\n  PermissionHookOptions,\n};\n"]}

package/expo-module.config.json

@@ -8,7 +8,7 @@
     "publication": {
       "groupId": "host.exp.exponent",
       "artifactId": "expo.modules.screencapture",
-      "version": "7.1.5-canary-20250612-338ef55",
+      "version": "7.2.0-canary-20250613-b29d676-1",
       "repository": "local-maven-repo"
     }
   }

package/local-maven-repo/host/exp/exponent/expo.modules.screencapture/{7.1.5-canary-20250612-338ef55/expo.modules.screencapture-7.1.5-canary-20250612-338ef55.module → 7.2.0-canary-20250613-b29d676-1/expo.modules.screencapture-7.2.0-canary-20250613-b29d676-1.module}

@@ -3,7 +3,7 @@
   "component": {
     "group": "host.exp.exponent",
     "module": "expo.modules.screencapture",
-    "version": "7.1.5-canary-20250612-338ef55",
+    "version": "7.2.0-canary-20250613-b29d676-1",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -24,8 +24,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.screencapture-7.1.5-canary-20250612-338ef55.aar",
-          "url": "expo.modules.screencapture-7.1.5-canary-20250612-338ef55.aar",
+          "name": "expo.modules.screencapture-7.2.0-canary-20250613-b29d676-1.aar",
+          "url": "expo.modules.screencapture-7.2.0-canary-20250613-b29d676-1.aar",
           "size": 28245,
           "sha512": "5d693f6a83cc09074f42ae55d49f7cccfc0c2e1f024e43d866c285e18f0e37648ff966eb7507567538355f6d9f1b6c7d51f6eb45456dbe191ad41f3ae896f930",
           "sha256": "8a9e3dca21a096209a62e8ce26c3733e57135f9d59a41eb237636ae81c744345",
@@ -60,8 +60,8 @@
       ],
       "files": [
         {
-          "name": "expo.modules.screencapture-7.1.5-canary-20250612-338ef55.aar",
-          "url": "expo.modules.screencapture-7.1.5-canary-20250612-338ef55.aar",
+          "name": "expo.modules.screencapture-7.2.0-canary-20250613-b29d676-1.aar",
+          "url": "expo.modules.screencapture-7.2.0-canary-20250613-b29d676-1.aar",
           "size": 28245,
           "sha512": "5d693f6a83cc09074f42ae55d49f7cccfc0c2e1f024e43d866c285e18f0e37648ff966eb7507567538355f6d9f1b6c7d51f6eb45456dbe191ad41f3ae896f930",
           "sha256": "8a9e3dca21a096209a62e8ce26c3733e57135f9d59a41eb237636ae81c744345",
@@ -80,8 +80,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.screencapture-7.1.5-canary-20250612-338ef55-sources.jar",
-          "url": "expo.modules.screencapture-7.1.5-canary-20250612-338ef55-sources.jar",
+          "name": "expo.modules.screencapture-7.2.0-canary-20250613-b29d676-1-sources.jar",
+          "url": "expo.modules.screencapture-7.2.0-canary-20250613-b29d676-1-sources.jar",
           "size": 3601,
           "sha512": "080676e6818f1d063d27b7b460c49e34d7ebeae5e6a6e4c071840008b10a6beaafe0022467b6f556a1a190b22ae6b04ef87de7e7c2a74364b5af845efa1a6b05",
           "sha256": "d2c5b19e0bb1ad883b35525cdce5c665213505bea5b758f0c0c44b735fc960eb",

package/local-maven-repo/host/exp/exponent/expo.modules.screencapture/7.2.0-canary-20250613-b29d676-1/expo.modules.screencapture-7.2.0-canary-20250613-b29d676-1.module.md5

@@ -0,0 +1 @@
+6e82bb959353cecb8f7440c9f201e1c9

package/local-maven-repo/host/exp/exponent/expo.modules.screencapture/7.2.0-canary-20250613-b29d676-1/expo.modules.screencapture-7.2.0-canary-20250613-b29d676-1.module.sha1

@@ -0,0 +1 @@
+375a260c87546456f786d2fc1897385892446f2f

package/local-maven-repo/host/exp/exponent/expo.modules.screencapture/7.2.0-canary-20250613-b29d676-1/expo.modules.screencapture-7.2.0-canary-20250613-b29d676-1.module.sha256

@@ -0,0 +1 @@
+19530766a4f5d9f685a091600dcf82ede229b897375531ddae2c00b9c8b23991

package/local-maven-repo/host/exp/exponent/expo.modules.screencapture/7.2.0-canary-20250613-b29d676-1/expo.modules.screencapture-7.2.0-canary-20250613-b29d676-1.module.sha512

@@ -0,0 +1 @@
+125657293cc31823a7fede174f61858f4b1cb89b1314355751d77693cec4c08ab12901243b8396592cf94b2e37d9d7b7a58b47ce8f7cded45d0e70881ac124e6

package/local-maven-repo/host/exp/exponent/expo.modules.screencapture/{7.1.5-canary-20250612-338ef55/expo.modules.screencapture-7.1.5-canary-20250612-338ef55.pom → 7.2.0-canary-20250613-b29d676-1/expo.modules.screencapture-7.2.0-canary-20250613-b29d676-1.pom}

@@ -9,7 +9,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.screencapture</artifactId>
-  <version>7.1.5-canary-20250612-338ef55</version>
+  <version>7.2.0-canary-20250613-b29d676-1</version>
   <packaging>aar</packaging>
   <name>expo.modules.screencapture</name>
   <url>https://github.com/expo/expo</url>

package/local-maven-repo/host/exp/exponent/expo.modules.screencapture/7.2.0-canary-20250613-b29d676-1/expo.modules.screencapture-7.2.0-canary-20250613-b29d676-1.pom.md5

@@ -0,0 +1 @@
+7d9f47f0f158b04e43b8c7a4aff24e3f

package/local-maven-repo/host/exp/exponent/expo.modules.screencapture/7.2.0-canary-20250613-b29d676-1/expo.modules.screencapture-7.2.0-canary-20250613-b29d676-1.pom.sha1

@@ -0,0 +1 @@
+5850e0aa38b47f0534e3900d540f04ef4e610d70

package/local-maven-repo/host/exp/exponent/expo.modules.screencapture/7.2.0-canary-20250613-b29d676-1/expo.modules.screencapture-7.2.0-canary-20250613-b29d676-1.pom.sha256

@@ -0,0 +1 @@
+0d25c6749590ec5fc0ed2a1a2076e7a75996058cab50bc8c7e85c19266b45ec1

package/local-maven-repo/host/exp/exponent/expo.modules.screencapture/7.2.0-canary-20250613-b29d676-1/expo.modules.screencapture-7.2.0-canary-20250613-b29d676-1.pom.sha512

@@ -0,0 +1 @@
+0e80f676edf265d31d153277903015500420b80b14af1e76354aa5b6748152626a6cb36ac71a0930152ff3647bf3087bd7a9d733c6a985600f5d864e2862703d

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

@@ -3,11 +3,11 @@
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.screencapture</artifactId>
   <versioning>
-    <latest>7.1.5-canary-20250612-338ef55</latest>
-    <release>7.1.5-canary-20250612-338ef55</release>
+    <latest>7.2.0-canary-20250613-b29d676-1</latest>
+    <release>7.2.0-canary-20250613-b29d676-1</release>
     <versions>
-      <version>7.1.5-canary-20250612-338ef55</version>
+      <version>7.2.0-canary-20250613-b29d676-1</version>
     </versions>
-    <lastUpdated>20250612174740</lastUpdated>
+    <lastUpdated>20250613142649</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-20fd849041c184221e25d51a57e32f28
+72cd1ee8e5ebc87e51e897931840877d

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

@@ -1 +1 @@
-47ad8e3bda96b3970b0566a889bcd8266db9d8a8
+6810a5bbb10d6c70f9a264dcc0696d6feb13b734

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

@@ -1 +1 @@
-626509b3908cd3338ef06f51ba4a5b71e405cc878010d178af4821a372394850
+e81d002c6907873b93c4e6e98d09fe3ce8227732e946eb9c14362c7c6333c3e7

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

@@ -1 +1 @@
-86b116baee9358ed8d70b4a4c4a0e0c295494d9a2b0ebe067bdacf6bea341e4855296059fa6459b8cf42f5bea4dc6b0830d1ff6d1f7b848baad36234a194adf3
+e0e3e773a4203a795c807f4c06b71359fd7ce9b33d3794dac3868e56ac3e5acd545e38713d3b790ade462d387475397b835986697e40f736d631494930e6f3d9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-screen-capture",
-  "version": "7.1.5-canary-20250612-338ef55",
+  "version": "7.2.0-canary-20250613-b29d676-1",
   "description": "Protects screens in your app from being captured or recorded, and notifies if a screenshot is taken.",
   "main": "build/ScreenCapture.js",
   "types": "build/ScreenCapture.d.ts",
@@ -35,10 +35,10 @@
   "dependencies": {},
   "devDependencies": {
     "@testing-library/react-native": "^13.1.0",
-    "expo-module-scripts": "4.1.8-canary-20250612-338ef55"
+    "expo-module-scripts": "4.1.8-canary-20250613-b29d676-1"
   },
   "peerDependencies": {
-    "expo": "54.0.0-canary-20250612-338ef55",
+    "expo": "54.0.0-canary-20250613-b29d676-1",
     "react": "*"
   }
 }

package/src/ScreenCapture.ts

@@ -133,6 +133,25 @@ export function removeScreenshotListener(subscription: EventSubscription) {
   subscription.remove();
 }
 
+// @needsAudit
+/**
+ * A React hook that listens for screenshots taken while the component is mounted.
+ *
+ * @param listener A function that will be called whenever a screenshot is detected.
+ *
+ * This hook automatically starts listening when the component mounts, and stops
+ * listening when the component unmounts.
+ */
+export function useScreenshotListener(listener: () => void) {
+  useEffect(() => {
+    const subscription = addScreenshotListener(listener);
+
+    return () => {
+      removeScreenshotListener(subscription);
+    };
+  }, [listener]);
+}
+
 /**
  * Checks user's permissions for detecting when a screenshot is taken.
  * > Only Android requires additional permissions to detect screenshots. On iOS devices, this method will always resolve to a `granted` permission response.

package/local-maven-repo/host/exp/exponent/expo.modules.screencapture/7.1.5-canary-20250612-338ef55/expo.modules.screencapture-7.1.5-canary-20250612-338ef55.module.md5

@@ -1 +0,0 @@
-1361fb2bf3d421d5deee67d48f0a5685

package/local-maven-repo/host/exp/exponent/expo.modules.screencapture/7.1.5-canary-20250612-338ef55/expo.modules.screencapture-7.1.5-canary-20250612-338ef55.module.sha1

@@ -1 +0,0 @@
-96c3741f0579125b67d9b5b80b3cedd1f0ded53f

package/local-maven-repo/host/exp/exponent/expo.modules.screencapture/7.1.5-canary-20250612-338ef55/expo.modules.screencapture-7.1.5-canary-20250612-338ef55.module.sha256

@@ -1 +0,0 @@
-354e3930a90983e8e3e0c17e65351fce76a3051313a4437835827be6d52243e4

package/local-maven-repo/host/exp/exponent/expo.modules.screencapture/7.1.5-canary-20250612-338ef55/expo.modules.screencapture-7.1.5-canary-20250612-338ef55.module.sha512

@@ -1 +0,0 @@
-745dd0664e60a81ea79b8793bea76537173bd93c64ed0d5707a37dce2006d409111c23788fba491b3a6637062e1fcf022e47ba6e0421606e6bb0e1acf5c7e2ab

package/local-maven-repo/host/exp/exponent/expo.modules.screencapture/7.1.5-canary-20250612-338ef55/expo.modules.screencapture-7.1.5-canary-20250612-338ef55.pom.md5

@@ -1 +0,0 @@
-07265b0bf84e2cae47b5aafcc6ee2f85

package/local-maven-repo/host/exp/exponent/expo.modules.screencapture/7.1.5-canary-20250612-338ef55/expo.modules.screencapture-7.1.5-canary-20250612-338ef55.pom.sha1

@@ -1 +0,0 @@
-16cda288f163f3a304a5650585c2760232741fee

package/local-maven-repo/host/exp/exponent/expo.modules.screencapture/7.1.5-canary-20250612-338ef55/expo.modules.screencapture-7.1.5-canary-20250612-338ef55.pom.sha256

@@ -1 +0,0 @@
-560fbff7ca00002a67886d6662391c183328024a8b667965a63d2faa59d894e2

package/local-maven-repo/host/exp/exponent/expo.modules.screencapture/7.1.5-canary-20250612-338ef55/expo.modules.screencapture-7.1.5-canary-20250612-338ef55.pom.sha512

@@ -1 +0,0 @@
-532ec8fa6cdc6171864e7af9095f041744b7b1250a61867e0bec50563880ac1725189d9c20f6e95aced443ce3c74d49c5ddf4e8fa05b0dc27205048b64ca026e