@abrarmehraj/permission-kit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-present 650 Industries, Inc. (aka Expo)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,119 @@
+# @abrarmehraj/permission-kit
+
+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.
+
+```ts
+const result = await PermissionKit.batteryOptimization();
+// { status: 'granted' } or { status: 'denied' }
+```
+
+---
+
+## Installation
+
+```bash
+npm install @abrarmehraj/permission-kit
+# or
+yarn add @abrarmehraj/permission-kit
+# or
+pnpm add @abrarmehraj/permission-kit
+```
+
+## Setup
+
+### For Expo Projects (Recommended)
+
+Use the built-in Config Plugin to automatically handle Android permissions. This ensures you only request the permissions you actually use!
+
+In your `app.json`, add the plugin and specify the permissions you want:
+
+```json
+{
+  "expo": {
+    "plugins": [
+      [
+        "@abrarmehraj/permission-kit",
+        {
+          "permissions": ["batteryOptimization"]
+        }
+      ]
+    ]
+  }
+}
+```
+
+Then run:
+```bash
+npx expo prebuild
+```
+
+### For Bare React Native Projects (Without Expo Prebuild)
+
+If you are not using Expo Prebuild, you must manage your `AndroidManifest.xml` manually. 
+
+Add the required permission to your `android/app/src/main/AndroidManifest.xml` ONLY IF you intend to use it:
+
+```xml
+<uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />
+```
+
+> **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.
+
+## API
+
+### `PermissionKit.batteryOptimization()`
+
+Checks if battery optimization is disabled for your app. If not, automatically opens the Android Settings dialog and waits for the user to return. Re-checks on resume.
+
+```ts
+import { PermissionKit } from '@abrarmehraj/permission-kit';
+
+const result = await PermissionKit.batteryOptimization();
+
+if (result.status === 'granted') {
+  // App is excluded from battery optimization
+} else if (result.status === 'denied') {
+  // User denied
+} else if (result.status === 'unavailable') {
+  // Platform doesn't support this (e.g., iOS)
+}
+```
+
+### `PermissionKit.checkBatteryOptimization()`
+
+Check the current status without showing any dialog or opening settings.
+
+```ts
+const result = await PermissionKit.checkBatteryOptimization();
+// Use on app start to know the current state
+```
+
+---
+
+## Platform Support
+
+| Feature               | Android | iOS              |
+|-----------------------|---------|------------------|
+| Battery Optimization  | ✅      | `unavailable` ⚠️ |
+
+> **iOS Note**: iOS does not have Android-style battery optimization. Calling `batteryOptimization()` on iOS immediately returns `{ status: 'unavailable' }` without showing any UI.
+
+---
+
+## Roadmap
+
+- [x] Battery Optimization (Android)
+- [ ] Notifications (Android + iOS)
+- [ ] Exact Alarm (Android)
+- [ ] DND Access (Android)
+- [ ] Overlay Permission (Android)
+- [x] Expo Config Plugin
+- [ ] Standalone Package
+
+---
+
+## License
+
+MIT

package/android/build/.transforms/3c361e3bc775e7d34547424688ff1c77/results.bin

@@ -0,0 +1 @@
+o/bundleLibRuntimeToDirDebug

package/android/build/.transforms/61a81db1043cb114cc6c946ab145548f/results.bin

@@ -0,0 +1 @@
+o/classes

package/android/build/.transforms/89e4d01fa013a5f232b92431ae151ffc/results.bin

@@ -0,0 +1 @@
+o/classes

package/android/build/.transforms/9fa24db55b8bf43f3fc0f8d12a30cf44/results.bin

@@ -0,0 +1 @@
+o/bundleLibRuntimeToDirDebug

package/android/build/generated/source/buildConfig/debug/expo/modules/permissionkit/BuildConfig.java

@@ -0,0 +1,10 @@
+/**
+ * Automatically generated file. DO NOT MODIFY
+ */
+package expo.modules.permissionkit;
+
+public final class BuildConfig {
+  public static final boolean DEBUG = Boolean.parseBoolean("true");
+  public static final String LIBRARY_PACKAGE_NAME = "expo.modules.permissionkit";
+  public static final String BUILD_TYPE = "debug";
+}

package/android/build/intermediates/aapt_friendly_merged_manifests/debug/processDebugManifest/aapt/AndroidManifest.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="expo.modules.permissionkit" >
+
+    <uses-sdk android:minSdkVersion="24" />
+
+</manifest>

package/android/build/intermediates/aapt_friendly_merged_manifests/debug/processDebugManifest/aapt/output-metadata.json

@@ -0,0 +1,18 @@
+{
+  "version": 3,
+  "artifactType": {
+    "type": "AAPT_FRIENDLY_MERGED_MANIFESTS",
+    "kind": "Directory"
+  },
+  "applicationId": "expo.modules.permissionkit",
+  "variantName": "debug",
+  "elements": [
+    {
+      "type": "SINGLE",
+      "filters": [],
+      "attributes": [],
+      "outputFile": "AndroidManifest.xml"
+    }
+  ],
+  "elementType": "File"
+}

package/android/build/intermediates/aar_metadata/debug/writeDebugAarMetadata/aar-metadata.properties

@@ -0,0 +1,6 @@
+aarFormatVersion=1.0
+aarMetadataVersion=1.0
+minCompileSdk=1
+minCompileSdkExtension=0
+minAndroidGradlePluginVersion=1.0.0
+coreLibraryDesugaringEnabled=false

package/android/build/intermediates/annotation_processor_list/debug/javaPreCompileDebug/annotationProcessors.json

@@ -0,0 +1 @@
+{}

package/android/build/intermediates/incremental/debug/packageDebugResources/compile-file-map.properties

@@ -0,0 +1 @@
+#Fri Jun 05 19:04:21 IST 2026

package/android/build/intermediates/incremental/debug/packageDebugResources/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="main$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/src/main/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="main" generated-set="main$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/src/main/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="debug$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/src/debug/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="debug" generated-set="debug$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/src/debug/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="generated$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/build/generated/res/resValues/debug"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="generated" generated-set="generated$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/build/generated/res/resValues/debug"/></dataSet><mergedItems/></merger>

package/android/build/intermediates/incremental/mergeDebugAssets/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet config="main" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/src/main/assets"/></dataSet><dataSet config="debug" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/src/debug/assets"/></dataSet><dataSet config="generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/build/intermediates/shader_assets/debug/compileDebugShaders/out"/></dataSet></merger>

package/android/build/intermediates/incremental/mergeDebugJniLibFolders/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet config="main" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/src/main/jniLibs"/></dataSet><dataSet config="debug" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/src/debug/jniLibs"/></dataSet></merger>

package/android/build/intermediates/incremental/mergeDebugShaders/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet config="main" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/src/main/shaders"/></dataSet><dataSet config="debug" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/src/debug/shaders"/></dataSet></merger>

package/android/build/intermediates/local_only_symbol_list/debug/parseDebugLocalResources/R-def.txt

@@ -0,0 +1,2 @@
+R_DEF: Internal format may change without notice
+local

package/android/build/intermediates/manifest_merge_blame_file/debug/processDebugManifest/manifest-merger-blame-debug-report.txt

@@ -0,0 +1,7 @@
+1<?xml version="1.0" encoding="utf-8"?>
+2<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+3    package="expo.modules.permissionkit" >
+4
+5    <uses-sdk android:minSdkVersion="24" />
+6
+7</manifest>

package/android/build/intermediates/merged_manifest/debug/processDebugManifest/AndroidManifest.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="expo.modules.permissionkit" >
+
+    <uses-sdk android:minSdkVersion="24" />
+
+</manifest>

package/android/build/intermediates/navigation_json/debug/extractDeepLinksDebug/navigation.json

@@ -0,0 +1 @@
+[]

package/android/build/intermediates/nested_resources_validation_report/debug/generateDebugResources/nestedResourcesValidationReport.txt

@@ -0,0 +1 @@
+0 Warning/Error

package/android/build/intermediates/symbol_list_with_package_name/debug/generateDebugRFile/package-aware-r.txt

@@ -0,0 +1 @@
+expo.modules.permissionkit

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

@@ -0,0 +1,2 @@
+1
+0

package/android/build/outputs/logs/manifest-merger-debug-report.txt

@@ -0,0 +1,14 @@
+-- Merging decision tree log ---
+manifest
+ADDED from /Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/src/main/AndroidManifest.xml:1:1-2:12
+INJECTED from /Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/src/main/AndroidManifest.xml:1:1-2:12
+	package
+		INJECTED from /Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/src/main/AndroidManifest.xml
+uses-sdk
+INJECTED from /Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/src/main/AndroidManifest.xml reason: use-sdk injection requested
+INJECTED from /Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/src/main/AndroidManifest.xml
+INJECTED from /Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/src/main/AndroidManifest.xml
+	android:targetSdkVersion
+		INJECTED from /Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/src/main/AndroidManifest.xml
+	android:minSdkVersion
+		INJECTED from /Users/abrarmehraj/Desktop/plugins-playground/modules/permission-kit/android/src/main/AndroidManifest.xml

package/android/build.gradle

@@ -0,0 +1,18 @@
+plugins {
+  id 'com.android.library'
+  id 'expo-module-gradle-plugin'
+}
+
+group = 'expo.modules.permissionkit'
+version = '0.1.0'
+
+android {
+  namespace "expo.modules.permissionkit"
+  defaultConfig {
+    versionCode 1
+    versionName "0.1.0"
+  }
+  lintOptions {
+    abortOnError false
+  }
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest>
+</manifest>