@abrarmehraj/permission-kit 0.1.1 → 0.1.2

package/README.md

@@ -36,7 +36,7 @@ In your `app.json`, add the plugin and specify the permissions you want:
       [
         "@abrarmehraj/permission-kit",
         {
-          "permissions": ["batteryOptimization"]
+          "permissions": ["batteryOptimization", "overlay"]
         }
       ]
     ]
@@ -57,6 +57,7 @@ Add the required permission to your `android/app/src/main/AndroidManifest.xml` O
 
 ```xml
 <uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />
+<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
 ```
 
 > **Note**: PermissionKit requires Expo Modules architecture. If you are on React Native 0.69+, you likely already have it. Make sure you run `npx pod-install` for iOS.
@@ -90,6 +91,26 @@ const result = await PermissionKit.checkBatteryOptimization();
 // Use on app start to know the current state
 ```
 
+### `PermissionKit.overlay()`
+
+Checks if the app is allowed to draw over other apps (System Alert Window). If not, automatically opens the Android Settings "Display over other apps" dialog, waits for the user to return, and re-checks on resume.
+
+```ts
+const result = await PermissionKit.overlay();
+
+if (result.status === 'granted') {
+  // App is allowed to draw over others
+}
+```
+
+### `PermissionKit.checkOverlay()`
+
+Check the current overlay status without opening settings.
+
+```ts
+const result = await PermissionKit.checkOverlay();
+```
+
 ---
 
 ## Platform Support
@@ -97,6 +118,7 @@ const result = await PermissionKit.checkBatteryOptimization();
 | Feature               | Android | iOS              |
 |-----------------------|---------|------------------|
 | Battery Optimization  | ✅      | `unavailable` ⚠️ |
+| Overlay Permission    | ✅      | `unavailable` ⚠️ |
 
 > **iOS Note**: iOS does not have Android-style battery optimization. Calling `batteryOptimization()` on iOS immediately returns `{ status: 'unavailable' }` without showing any UI.
 
@@ -105,10 +127,10 @@ const result = await PermissionKit.checkBatteryOptimization();
 ## Roadmap
 
 - [x] Battery Optimization (Android)
+- [x] Overlay Permission (Android)
 - [ ] Notifications (Android + iOS)
 - [ ] Exact Alarm (Android)
 - [ ] DND Access (Android)
-- [ ] Overlay Permission (Android)
 - [x] Expo Config Plugin
 - [ ] Standalone Package
 

package/android/build/kotlin/compileDebugKotlin/cacheable/caches-jvm/lookups/counters.tab

@@ -1,2 +1,2 @@
-3
+4
 0

package/android/src/main/java/expo/modules/permissionkit/ExpoPermissionKitModule.kt

@@ -10,6 +10,16 @@ import expo.modules.kotlin.modules.Module
 import expo.modules.kotlin.modules.ModuleDefinition
 
 class ExpoPermissionKitModule : Module() {
+  private fun hasManifestPermission(permission: String): Boolean {
+    val context = appContext.reactContext ?: return false
+    return try {
+      val packageInfo = context.packageManager.getPackageInfo(context.packageName, android.content.pm.PackageManager.GET_PERMISSIONS)
+      packageInfo.requestedPermissions?.contains(permission) == true
+    } catch (e: Exception) {
+      false
+    }
+  }
+
   override fun definition() = ModuleDefinition {
     Name("ExpoPermissionKit")
 
@@ -36,10 +46,7 @@ class ExpoPermissionKitModule : Module() {
       val packageName = context.packageName
 
       if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
-        if (androidx.core.content.ContextCompat.checkSelfPermission(
-            context, 
-            android.Manifest.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS
-          ) != android.content.pm.PackageManager.PERMISSION_GRANTED) {
+        if (!hasManifestPermission(android.Manifest.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS)) {
           throw Exception("MISSING_PERMISSION: Add batteryOptimization to your app.json plugin")
         }
 
@@ -52,5 +59,36 @@ class ExpoPermissionKitModule : Module() {
         context.startActivity(intent)
       }
     }
+
+    AsyncFunction("isOverlayPermissionEnabled") {
+      val context = appContext.reactContext
+        ?: throw Exception("Context unavailable")
+
+      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+        return@AsyncFunction Settings.canDrawOverlays(context)
+      }
+      return@AsyncFunction true
+    }
+
+    AsyncFunction("openOverlayPermissionSettings") {
+      val context = appContext.reactContext
+        ?: throw Exception("Context unavailable")
+
+      val packageName = context.packageName
+
+      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+        if (!hasManifestPermission(android.Manifest.permission.SYSTEM_ALERT_WINDOW)) {
+          throw Exception("MISSING_PERMISSION: Add 'overlay' to your app.json plugin")
+        }
+
+        val intent = Intent(
+          Settings.ACTION_MANAGE_OVERLAY_PERMISSION,
+          Uri.parse("package:$packageName")
+        )
+
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
+        context.startActivity(intent)
+      }
+    }
   }
 }

package/build/ExpoPermissionKitModule.d.ts

@@ -1,6 +1,8 @@
 export interface PermissionKitNativeModule {
     isBatteryOptimizationEnabled(): Promise<boolean>;
     openBatteryOptimizationSettings(): Promise<void>;
+    isOverlayPermissionEnabled(): Promise<boolean>;
+    openOverlayPermissionSettings(): Promise<void>;
 }
 declare let _nativeModule: PermissionKitNativeModule | null;
 export default _nativeModule;

package/build/ExpoPermissionKitModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoPermissionKitModule.d.ts","sourceRoot":"","sources":["../src/ExpoPermissionKitModule.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,yBAAyB;IACxC,4BAA4B,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,+BAA+B,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,QAAA,IAAI,aAAa,EAAE,yBAAyB,GAAG,IAAW,CAAC;AAO3D,eAAe,aAAa,CAAC"}
+{"version":3,"file":"ExpoPermissionKitModule.d.ts","sourceRoot":"","sources":["../src/ExpoPermissionKitModule.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,yBAAyB;IACxC,4BAA4B,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,+BAA+B,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,0BAA0B,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,QAAA,IAAI,aAAa,EAAE,yBAAyB,GAAG,IAAW,CAAC;AAO3D,eAAe,aAAa,CAAC"}

package/build/ExpoPermissionKitModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoPermissionKitModule.js","sourceRoot":"","sources":["../src/ExpoPermissionKitModule.ts"],"names":[],"mappings":";;AAAA,+BAA2C;AAO3C,IAAI,aAAa,GAAqC,IAAI,CAAC;AAC3D,IAAI,CAAC;IACH,aAAa,GAAG,IAAA,0BAAmB,EAA4B,mBAAmB,CAAC,CAAC;AACtF,CAAC;AAAC,WAAM,CAAC;IACP,0EAA0E;AAC5E,CAAC;AAED,kBAAe,aAAa,CAAC"}
+{"version":3,"file":"ExpoPermissionKitModule.js","sourceRoot":"","sources":["../src/ExpoPermissionKitModule.ts"],"names":[],"mappings":";;AAAA,+BAA2C;AAS3C,IAAI,aAAa,GAAqC,IAAI,CAAC;AAC3D,IAAI,CAAC;IACH,aAAa,GAAG,IAAA,0BAAmB,EAA4B,mBAAmB,CAAC,CAAC;AACtF,CAAC;AAAC,WAAM,CAAC;IACP,0EAA0E;AAC5E,CAAC;AAED,kBAAe,aAAa,CAAC"}

package/build/PermissionKit.d.ts

@@ -8,8 +8,20 @@ export declare function batteryOptimization(): Promise<{
 } | {
     status: "granted" | "denied";
 }>;
+export declare function checkOverlay(): Promise<{
+    status: "unavailable";
+} | {
+    status: "granted" | "denied";
+}>;
+export declare function overlay(): Promise<{
+    status: "unavailable";
+} | {
+    status: "granted" | "denied";
+}>;
 export declare const PermissionKit: {
     batteryOptimization: typeof batteryOptimization;
     checkBatteryOptimization: typeof checkBatteryOptimization;
+    overlay: typeof overlay;
+    checkOverlay: typeof checkOverlay;
 };
 //# sourceMappingURL=PermissionKit.d.ts.map

package/build/PermissionKit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PermissionKit.d.ts","sourceRoot":"","sources":["../src/PermissionKit.ts"],"names":[],"mappings":"AAGA,wBAAsB,wBAAwB;;;YAME,SAAS,GAAG,QAAQ;GAEnE;AAED,wBAAsB,mBAAmB;;;YAJO,SAAS,GAAG,QAAQ;GA8BnE;AAiBD,eAAO,MAAM,aAAa;;;CAGzB,CAAC"}
+{"version":3,"file":"PermissionKit.d.ts","sourceRoot":"","sources":["../src/PermissionKit.ts"],"names":[],"mappings":"AAGA,wBAAsB,wBAAwB;;;YAME,SAAS,GAAG,QAAQ;GAEnE;AAED,wBAAsB,mBAAmB;;;YAJO,SAAS,GAAG,QAAQ;GA8BnE;AAiBD,wBAAsB,YAAY;;;YAMc,SAAS,GAAG,QAAQ;GAEnE;AAED,wBAAsB,OAAO;;;YAJmB,SAAS,GAAG,QAAQ;GA8BnE;AAED,eAAO,MAAM,aAAa;;;;;CAKzB,CAAC"}

package/build/PermissionKit.js

@@ -6,6 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PermissionKit = void 0;
 exports.checkBatteryOptimization = checkBatteryOptimization;
 exports.batteryOptimization = batteryOptimization;
+exports.checkOverlay = checkOverlay;
+exports.overlay = overlay;
 const react_native_1 = require("react-native");
 const ExpoPermissionKitModule_1 = __importDefault(require("./ExpoPermissionKitModule"));
 async function checkBatteryOptimization() {
@@ -50,8 +52,41 @@ function waitForResume() {
         });
     });
 }
+async function checkOverlay() {
+    if (react_native_1.Platform.OS === 'ios' || !ExpoPermissionKitModule_1.default) {
+        return { status: 'unavailable' };
+    }
+    const enabled = await ExpoPermissionKitModule_1.default.isOverlayPermissionEnabled();
+    return {
+        status: (enabled ? 'granted' : 'denied'),
+    };
+}
+async function overlay() {
+    var _a;
+    if (react_native_1.Platform.OS === 'ios' || !ExpoPermissionKitModule_1.default) {
+        return { status: 'unavailable' };
+    }
+    const check = await checkOverlay();
+    if (check.status === 'granted') {
+        return check;
+    }
+    try {
+        await ExpoPermissionKitModule_1.default.openOverlayPermissionSettings();
+    }
+    catch (error) {
+        if ((_a = error === null || error === void 0 ? void 0 : error.message) === null || _a === void 0 ? void 0 : _a.includes('MISSING_PERMISSION')) {
+            console.warn("[@abrarmehraj/permission-kit] Missing Permission: You forgot to add 'overlay' to your app.json plugin.");
+            return { status: 'denied' };
+        }
+        throw error;
+    }
+    await waitForResume();
+    return await checkOverlay();
+}
 exports.PermissionKit = {
     batteryOptimization,
     checkBatteryOptimization,
+    overlay,
+    checkOverlay,
 };
 //# sourceMappingURL=PermissionKit.js.map

package/build/PermissionKit.js.map

@@ -1 +1 @@
-{"version":3,"file":"PermissionKit.js","sourceRoot":"","sources":["../src/PermissionKit.ts"],"names":[],"mappings":";;;;;;AAGA,4DAQC;AAED,kDA0BC;AAvCD,+CAAkD;AAClD,wFAAqD;AAE9C,KAAK,UAAU,wBAAwB;IAC5C,IAAI,uBAAQ,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC,iCAAY,EAAE,CAAC;QAC3C,OAAO,EAAE,MAAM,EAAE,aAAsB,EAAE,CAAC;IAC5C,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,iCAAY,CAAC,4BAA4B,EAAE,CAAC;IAClE,OAAO;QACL,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAyB;KACjE,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,mBAAmB;;IACvC,IAAI,uBAAQ,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC,iCAAY,EAAE,CAAC;QAC3C,OAAO,EAAE,MAAM,EAAE,aAAsB,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,wBAAwB,EAAE,CAAC;IAE/C,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,iCAAY,CAAC,+BAA+B,EAAE,CAAC;IACvD,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,IAAI,MAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,OAAO,0CAAE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;YACnD,OAAO,CAAC,IAAI,CACV,oHAAoH,CACrH,CAAC;YACF,OAAO,EAAE,MAAM,EAAE,QAAiB,EAAE,CAAC;QACvC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,aAAa,EAAE,CAAC;IAEtB,OAAO,MAAM,wBAAwB,EAAE,CAAC;AAC1C,CAAC;AAED,SAAS,aAAa;IACpB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;QAC3B,MAAM,GAAG,GAAG,uBAAQ,CAAC,gBAAgB,CACnC,QAAQ,EACR,CAAC,KAAK,EAAE,EAAE;YACR,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACvB,GAAG,CAAC,MAAM,EAAE,CAAC;gBACb,0DAA0D;gBAC1D,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAEY,QAAA,aAAa,GAAG;IAC3B,mBAAmB;IACnB,wBAAwB;CACzB,CAAC"}
+{"version":3,"file":"PermissionKit.js","sourceRoot":"","sources":["../src/PermissionKit.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abrarmehraj/permission-kit",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "A developer-friendly permissions library for Expo and React Native. One call handles the full workflow — check, request, wait for app resume, return final status.",
   "main": "build/index.js",
   "module": "build/index.js",

package/plugin/build/index.js

@@ -3,18 +3,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const config_plugins_1 = require("expo/config-plugins");
 const withPermissionKit = (config, props) => {
     const permissions = (props === null || props === void 0 ? void 0 : props.permissions) || [];
-    if (permissions.includes('batteryOptimization')) {
+    if (permissions.includes('batteryOptimization') || permissions.includes('overlay')) {
         config = (0, config_plugins_1.withAndroidManifest)(config, (config) => {
             const androidManifest = config.modResults;
             if (!androidManifest.manifest['uses-permission']) {
                 androidManifest.manifest['uses-permission'] = [];
             }
             const existingPermissions = androidManifest.manifest['uses-permission'].map((p) => p.$['android:name']);
-            if (!existingPermissions.includes('android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS')) {
+            if (permissions.includes('batteryOptimization') &&
+                !existingPermissions.includes('android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS')) {
                 androidManifest.manifest['uses-permission'].push({
-                    $: {
-                        'android:name': 'android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS',
-                    },
+                    $: { 'android:name': 'android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS' },
+                });
+            }
+            if (permissions.includes('overlay') &&
+                !existingPermissions.includes('android.permission.SYSTEM_ALERT_WINDOW')) {
+                androidManifest.manifest['uses-permission'].push({
+                    $: { 'android:name': 'android.permission.SYSTEM_ALERT_WINDOW' },
                 });
             }
             return config;

package/src/ExpoPermissionKitModule.ts

@@ -3,6 +3,8 @@ import { requireNativeModule } from 'expo';
 export interface PermissionKitNativeModule {
   isBatteryOptimizationEnabled(): Promise<boolean>;
   openBatteryOptimizationSettings(): Promise<void>;
+  isOverlayPermissionEnabled(): Promise<boolean>;
+  openOverlayPermissionSettings(): Promise<void>;
 }
 
 let _nativeModule: PermissionKitNativeModule | null = null;

package/src/PermissionKit.ts

@@ -54,7 +54,47 @@ function waitForResume(): Promise<void> {
   });
 }
 
+export async function checkOverlay() {
+  if (Platform.OS === 'ios' || !NativeModule) {
+    return { status: 'unavailable' as const };
+  }
+  const enabled = await NativeModule.isOverlayPermissionEnabled();
+  return {
+    status: (enabled ? 'granted' : 'denied') as 'granted' | 'denied',
+  };
+}
+
+export async function overlay() {
+  if (Platform.OS === 'ios' || !NativeModule) {
+    return { status: 'unavailable' as const };
+  }
+
+  const check = await checkOverlay();
+
+  if (check.status === 'granted') {
+    return check;
+  }
+
+  try {
+    await NativeModule.openOverlayPermissionSettings();
+  } catch (error: any) {
+    if (error?.message?.includes('MISSING_PERMISSION')) {
+      console.warn(
+        "[@abrarmehraj/permission-kit] Missing Permission: You forgot to add 'overlay' to your app.json plugin."
+      );
+      return { status: 'denied' as const };
+    }
+    throw error;
+  }
+
+  await waitForResume();
+
+  return await checkOverlay();
+}
+
 export const PermissionKit = {
   batteryOptimization,
   checkBatteryOptimization,
+  overlay,
+  checkOverlay,
 };