@abrarmehraj/permission-kit 0.1.0

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

@@ -0,0 +1,49 @@
+package expo.modules.permissionkit
+
+import android.content.Intent
+import android.net.Uri
+import android.os.Build
+import android.os.PowerManager
+import android.provider.Settings
+
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+
+class ExpoPermissionKitModule : Module() {
+  override fun definition() = ModuleDefinition {
+    Name("ExpoPermissionKit")
+
+    AsyncFunction("isBatteryOptimizationEnabled") {
+      val context = appContext.reactContext
+        ?: throw Exception("Context unavailable")
+
+      val powerManager =
+        context.getSystemService(android.content.Context.POWER_SERVICE)
+          as PowerManager
+
+      val packageName = context.packageName
+
+      val ignoring =
+        powerManager.isIgnoringBatteryOptimizations(packageName)
+
+      return@AsyncFunction ignoring
+    }
+
+    AsyncFunction("openBatteryOptimizationSettings") {
+      val context = appContext.reactContext
+        ?: throw Exception("Context unavailable")
+
+      val packageName = context.packageName
+
+      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+        val intent = Intent(
+          Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS,
+          Uri.parse("package:$packageName")
+        )
+
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
+        context.startActivity(intent)
+      }
+    }
+  }
+}

package/app.plugin.js

@@ -0,0 +1 @@
+module.exports = require('./plugin/build');

package/build/ExpoPermissionKit.types.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=ExpoPermissionKit.types.d.ts.map

package/build/ExpoPermissionKit.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpoPermissionKit.types.d.ts","sourceRoot":"","sources":["../src/ExpoPermissionKit.types.ts"],"names":[],"mappings":""}

package/build/ExpoPermissionKit.types.js

@@ -0,0 +1,3 @@
+"use strict";
+// Define your exported module types here.
+//# sourceMappingURL=ExpoPermissionKit.types.js.map

package/build/ExpoPermissionKit.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpoPermissionKit.types.js","sourceRoot":"","sources":["../src/ExpoPermissionKit.types.ts"],"names":[],"mappings":";AAAA,0CAA0C"}

package/build/ExpoPermissionKitModule.d.ts

@@ -0,0 +1,7 @@
+export interface PermissionKitNativeModule {
+    isBatteryOptimizationEnabled(): Promise<boolean>;
+    openBatteryOptimizationSettings(): Promise<void>;
+}
+declare let _nativeModule: PermissionKitNativeModule | null;
+export default _nativeModule;
+//# sourceMappingURL=ExpoPermissionKitModule.d.ts.map

package/build/ExpoPermissionKitModule.d.ts.map

@@ -0,0 +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"}

package/build/ExpoPermissionKitModule.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const expo_1 = require("expo");
+let _nativeModule = null;
+try {
+    _nativeModule = (0, expo_1.requireNativeModule)('ExpoPermissionKit');
+}
+catch (_a) {
+    // Native module not available on this platform (e.g., iOS simulator, web)
+}
+exports.default = _nativeModule;
+//# sourceMappingURL=ExpoPermissionKitModule.js.map

package/build/ExpoPermissionKitModule.js.map

@@ -0,0 +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"}

package/build/ExpoPermissionKitModule.web.d.ts

@@ -0,0 +1,6 @@
+import { NativeModule } from 'expo';
+declare class ExpoPermissionKitModule extends NativeModule<{}> {
+}
+declare const _default: typeof ExpoPermissionKitModule;
+export default _default;
+//# sourceMappingURL=ExpoPermissionKitModule.web.d.ts.map

package/build/ExpoPermissionKitModule.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpoPermissionKitModule.web.d.ts","sourceRoot":"","sources":["../src/ExpoPermissionKitModule.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,YAAY,EAAE,MAAM,MAAM,CAAC;AAGvD,cAAM,uBAAwB,SAAQ,YAAY,CAAC,EAAE,CAAC;CAAG;;AAEzD,wBAAqF"}

package/build/ExpoPermissionKitModule.web.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const expo_1 = require("expo");
+// ExpoPermissionKitModule is not available on the web platform.
+class ExpoPermissionKitModule extends expo_1.NativeModule {
+}
+exports.default = (0, expo_1.registerWebModule)(ExpoPermissionKitModule, 'ExpoPermissionKitModule');
+//# sourceMappingURL=ExpoPermissionKitModule.web.js.map

package/build/ExpoPermissionKitModule.web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpoPermissionKitModule.web.js","sourceRoot":"","sources":["../src/ExpoPermissionKitModule.web.ts"],"names":[],"mappings":";;AAAA,+BAAuD;AAEvD,gEAAgE;AAChE,MAAM,uBAAwB,SAAQ,mBAAgB;CAAG;AAEzD,kBAAe,IAAA,wBAAiB,EAAC,uBAAuB,EAAE,yBAAyB,CAAC,CAAC"}

package/build/PermissionKit.d.ts

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

package/build/PermissionKit.d.ts.map

@@ -0,0 +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;GAoBnE;AAiBD,eAAO,MAAM,aAAa;;;CAGzB,CAAC"}

package/build/PermissionKit.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PermissionKit = void 0;
+exports.checkBatteryOptimization = checkBatteryOptimization;
+exports.batteryOptimization = batteryOptimization;
+const react_native_1 = require("react-native");
+const ExpoPermissionKitModule_1 = __importDefault(require("./ExpoPermissionKitModule"));
+async function checkBatteryOptimization() {
+    if (react_native_1.Platform.OS === 'ios' || !ExpoPermissionKitModule_1.default) {
+        return { status: 'unavailable' };
+    }
+    const enabled = await ExpoPermissionKitModule_1.default.isBatteryOptimizationEnabled();
+    return {
+        status: (enabled ? 'granted' : 'denied'),
+    };
+}
+async function batteryOptimization() {
+    if (react_native_1.Platform.OS === 'ios' || !ExpoPermissionKitModule_1.default) {
+        return { status: 'unavailable' };
+    }
+    const check = await checkBatteryOptimization();
+    if (check.status === 'granted') {
+        return check;
+    }
+    await ExpoPermissionKitModule_1.default.openBatteryOptimizationSettings();
+    await waitForResume();
+    return await checkBatteryOptimization();
+}
+function waitForResume() {
+    return new Promise(resolve => {
+        const sub = react_native_1.AppState.addEventListener('change', (state) => {
+            if (state === 'active') {
+                sub.remove();
+                // Add a short delay to allow native settings to propagate
+                setTimeout(resolve, 500);
+            }
+        });
+    });
+}
+exports.PermissionKit = {
+    batteryOptimization,
+    checkBatteryOptimization,
+};
+//# sourceMappingURL=PermissionKit.js.map

package/build/PermissionKit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PermissionKit.js","sourceRoot":"","sources":["../src/PermissionKit.ts"],"names":[],"mappings":";;;;;;AAGA,4DAQC;AAED,kDAgBC;AA7BD,+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,MAAM,iCAAY,CAAC,+BAA+B,EAAE,CAAC;IAErD,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"}

package/build/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export { PermissionKit } from './PermissionKit';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/build/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PermissionKit = void 0;
+__exportStar(require("./types"), exports);
+var PermissionKit_1 = require("./PermissionKit");
+Object.defineProperty(exports, "PermissionKit", { enumerable: true, get: function () { return PermissionKit_1.PermissionKit; } });
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA"}

package/build/types.d.ts

@@ -0,0 +1,5 @@
+export type PermissionStatus = 'granted' | 'denied' | 'blocked' | 'unavailable';
+export interface PermissionResult {
+    status: PermissionStatus;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,QAAQ,GACR,SAAS,GACT,aAAa,CAAC;AAElB,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,CAAC;CAC1B"}

package/build/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/expo-module.config.json

@@ -0,0 +1,9 @@
+{
+  "platforms": ["apple", "android"],
+  "apple": {
+    "modules": ["ExpoPermissionKitModule"]
+  },
+  "android": {
+    "modules": ["expo.modules.permissionkit.ExpoPermissionKitModule"]
+  }
+}

package/ios/ExpoPermissionKit.podspec

@@ -0,0 +1,23 @@
+Pod::Spec.new do |s|
+  s.name           = 'ExpoPermissionKit'
+  s.version        = '0.1.0'
+  s.summary        = 'A developer-friendly permissions library for Expo and React Native.'
+  s.description    = 'One call handles the full workflow — check, request, wait for app resume, return final status.'
+  s.author         = { 'Abrar Mehraj' => '' }
+  s.homepage       = 'https://github.com/AbrarMehraj/plugins-playground'
+  s.platforms      = {
+    :ios => '16.4',
+    :tvos => '16.4'
+  }
+  s.source         = { git: 'https://github.com/AbrarMehraj/plugins-playground.git', tag: s.version.to_s }
+  s.static_framework = true
+
+  s.dependency 'ExpoModulesCore'
+
+  # Swift/Objective-C compatibility
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES',
+  }
+
+  s.source_files = "**/*.{h,m,mm,swift,hpp,cpp}"
+end

package/ios/ExpoPermissionKitModule.swift

@@ -0,0 +1,18 @@
+import ExpoModulesCore
+
+public class ExpoPermissionKitModule: Module {
+  public func definition() -> ModuleDefinition {
+    Name("ExpoPermissionKit")
+
+    // iOS does not have Android-style battery optimization.
+    // Low Power Mode is read-only and cannot be requested programmatically.
+    // We return false to let the JS layer produce { status: 'unavailable' }.
+    AsyncFunction("isBatteryOptimizationEnabled") { () -> Bool in
+      return false
+    }
+
+    AsyncFunction("openBatteryOptimizationSettings") { () -> Void in
+      // No-op on iOS — there is no equivalent settings screen.
+    }
+  }
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@abrarmehraj/permission-kit",
+  "version": "0.1.0",
+  "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",
+  "types": "build/index.d.ts",
+  "files": [
+    "build",
+    "plugin/build",
+    "app.plugin.js",
+    "src",
+    "android",
+    "ios",
+    "expo-module.config.json",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "../../node_modules/.bin/tsc -p tsconfig.json && ../../node_modules/.bin/tsc -p plugin/tsconfig.json",
+    "clean": "rm -rf build plugin/build"
+  },
+  "keywords": [
+    "expo",
+    "react-native",
+    "permissions",
+    "android",
+    "battery",
+    "battery-optimization",
+    "expo-module"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AbrarMehraj/plugins-playground"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "expo": ">=50.0.0",
+    "react": "*",
+    "react-native": "*"
+  },
+  "devDependencies": {
+    "typescript": "~6.0.3",
+    "@types/react": "~19.2.2"
+  }
+}

package/plugin/build/index.js

@@ -0,0 +1,25 @@
+"use strict";
+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')) {
+        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')) {
+                androidManifest.manifest['uses-permission'].push({
+                    $: {
+                        'android:name': 'android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS',
+                    },
+                });
+            }
+            return config;
+        });
+    }
+    return config;
+};
+exports.default = withPermissionKit;

package/src/ExpoPermissionKit.types.ts

@@ -0,0 +1 @@
+// Define your exported module types here.

package/src/ExpoPermissionKitModule.ts

@@ -0,0 +1,15 @@
+import { requireNativeModule } from 'expo';
+
+export interface PermissionKitNativeModule {
+  isBatteryOptimizationEnabled(): Promise<boolean>;
+  openBatteryOptimizationSettings(): Promise<void>;
+}
+
+let _nativeModule: PermissionKitNativeModule | null = null;
+try {
+  _nativeModule = requireNativeModule<PermissionKitNativeModule>('ExpoPermissionKit');
+} catch {
+  // Native module not available on this platform (e.g., iOS simulator, web)
+}
+
+export default _nativeModule;

package/src/ExpoPermissionKitModule.web.ts

@@ -0,0 +1,6 @@
+import { registerWebModule, NativeModule } from 'expo';
+
+// ExpoPermissionKitModule is not available on the web platform.
+class ExpoPermissionKitModule extends NativeModule<{}> {}
+
+export default registerWebModule(ExpoPermissionKitModule, 'ExpoPermissionKitModule');

package/src/PermissionKit.ts

@@ -0,0 +1,50 @@
+import { AppState, Platform } from 'react-native';
+import NativeModule from './ExpoPermissionKitModule';
+
+export async function checkBatteryOptimization() {
+  if (Platform.OS === 'ios' || !NativeModule) {
+    return { status: 'unavailable' as const };
+  }
+  const enabled = await NativeModule.isBatteryOptimizationEnabled();
+  return {
+    status: (enabled ? 'granted' : 'denied') as 'granted' | 'denied',
+  };
+}
+
+export async function batteryOptimization() {
+  if (Platform.OS === 'ios' || !NativeModule) {
+    return { status: 'unavailable' as const };
+  }
+
+  const check = await checkBatteryOptimization();
+
+  if (check.status === 'granted') {
+    return check;
+  }
+
+  await NativeModule.openBatteryOptimizationSettings();
+
+  await waitForResume();
+
+  return await checkBatteryOptimization();
+}
+
+function waitForResume(): Promise<void> {
+  return new Promise(resolve => {
+    const sub = AppState.addEventListener(
+      'change',
+      (state) => {
+        if (state === 'active') {
+          sub.remove();
+          // Add a short delay to allow native settings to propagate
+          setTimeout(resolve, 500);
+        }
+      }
+    );
+  });
+}
+
+export const PermissionKit = {
+  batteryOptimization,
+  checkBatteryOptimization,
+};

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export { PermissionKit } from './PermissionKit';

package/src/types.ts

@@ -0,0 +1,9 @@
+export type PermissionStatus =
+  | 'granted'
+  | 'denied'
+  | 'blocked'
+  | 'unavailable';
+
+export interface PermissionResult {
+  status: PermissionStatus;
+}