react-native-permission-handler 0.1.0 → 0.2.1

package/README.md

@@ -2,31 +2,35 @@
 
 Smart permission UX flows for React Native. Pre-prompts, blocked handling, settings redirect, and foreground re-check — in one hook.
 
-Built on [`react-native-permissions`](https://github.com/zoontek/react-native-permissions).
+Works with [`react-native-permissions`](https://github.com/zoontek/react-native-permissions), [Expo modules](https://docs.expo.dev/guides/permissions/), or any custom permissions backend via the pluggable engine architecture.
 
 ## Why
 
-Every React Native app that uses device features needs runtime permissions. The low-level check/request API is solved by `react-native-permissions`. But the **UX flow** — pre-prompts, blocked state recovery, settings redirect, foreground re-check — is not. Every team builds the same 150+ lines of boilerplate for every permission, in every project.
+Every React Native app that uses device features needs runtime permissions. The low-level check/request API is solved by libraries like `react-native-permissions` or Expo modules. But the **UX flow** — pre-prompts, blocked state recovery, settings redirect, foreground re-check — is not. Every team builds the same 150+ lines of boilerplate for every permission, in every project.
 
-This library handles the full flow in a single hook call.
+This library handles the full flow in a single hook call, with any permissions backend.
 
 ## Quick Start
 
 ```bash
-npm install react-native-permission-handler react-native-permissions
+npm install react-native-permission-handler
 ```
 
-Set up `react-native-permissions` for your platform ([iOS](https://github.com/zoontek/react-native-permissions#ios) / [Android](https://github.com/zoontek/react-native-permissions#android) / [Expo](https://github.com/zoontek/react-native-permissions#expo)).
+### With react-native-permissions (zero config)
 
-Then:
+If you have `react-native-permissions` installed, everything works out of the box — no engine configuration needed.
+
+```bash
+npm install react-native-permissions
+```
 
 ```tsx
 import { usePermissionHandler } from "react-native-permission-handler";
-import { PERMISSIONS } from "react-native-permissions";
+import { Permissions } from "react-native-permission-handler/rnp";
 
 function QRScannerScreen() {
   const camera = usePermissionHandler({
-    permission: PERMISSIONS.IOS.CAMERA,
+    permission: Permissions.CAMERA,
     prePrompt: {
       title: "Camera Access",
       message: "We need your camera to scan QR codes.",
@@ -47,7 +51,72 @@ function QRScannerScreen() {
 }
 ```
 
-That's it. The hook handles checking on mount, showing a pre-prompt before the system dialog, detecting blocked state, opening Settings, re-checking when the app returns, and firing callbacks.
+### With Expo modules
+
+```bash
+npm install expo-camera expo-notifications  # whichever modules you need
+```
+
+```tsx
+import { setDefaultEngine } from "react-native-permission-handler";
+import { createExpoEngine } from "react-native-permission-handler/expo";
+import * as Camera from "expo-camera";
+import * as Notifications from "expo-notifications";
+
+// Set once at app startup
+setDefaultEngine(
+  createExpoEngine({
+    permissions: {
+      camera: Camera,
+      notifications: Notifications,
+    },
+  })
+);
+```
+
+Then use the hooks with plain string identifiers:
+
+```tsx
+const camera = usePermissionHandler({
+  permission: "camera",
+  prePrompt: { title: "Camera", message: "We need camera access." },
+  blockedPrompt: { title: "Blocked", message: "Enable in Settings." },
+});
+```
+
+### With a custom engine
+
+Implement the `PermissionEngine` interface to use any permissions backend:
+
+```tsx
+import type { PermissionEngine } from "react-native-permission-handler";
+
+const myEngine: PermissionEngine = {
+  check: async (permission) => { /* return "granted" | "denied" | "blocked" | "limited" | "unavailable" */ },
+  request: async (permission) => { /* request and return status */ },
+  openSettings: async () => { /* open app settings */ },
+};
+
+// Use globally
+setDefaultEngine(myEngine);
+
+// Or per-hook
+const camera = usePermissionHandler({
+  permission: "camera",
+  engine: myEngine,
+  // ...
+});
+```
+
+## Engine Resolution
+
+When a hook needs to call a permission API, it resolves the engine in this order:
+
+1. **Config prop** — `engine` passed directly to the hook/component
+2. **Global default** — set via `setDefaultEngine()`
+3. **Auto-fallback** — lazily loads `react-native-permissions` if installed
+
+If none of the above resolves, a clear error message explains the three options.
 
 ## State Machine
 
@@ -98,11 +167,11 @@ The core of the library is a pure state machine that drives the entire permissio
 | `prePrompt` | Permission is requestable. Show a friendly explanation before the system dialog. |
 | `requesting` | System permission dialog is showing. |
 | `granted` | Permission is granted. Show the protected content. |
-| `denied` | User dismissed the pre-prompt ("Not Now") or denied via system dialog. Permission is still requestable next time. |
+| `denied` | User dismissed the pre-prompt or denied via system dialog. Still requestable. |
 | `blocked` | Permission is permanently denied. Only Settings can fix it. |
 | `blockedPrompt` | Showing the "go to Settings" prompt. |
-| `openingSettings` | User tapped "Open Settings". Waiting for app to return to foreground. |
-| `recheckingAfterSettings` | App returned from Settings. Re-checking permission status. |
+| `openingSettings` | User tapped "Open Settings". Waiting for return. |
+| `recheckingAfterSettings` | App returned from Settings. Re-checking status. |
 | `unavailable` | Device doesn't support this feature. Terminal state. |
 
 ## API Reference
@@ -115,33 +184,31 @@ The main hook. Manages the full permission lifecycle.
 
 ```typescript
 {
-  // The permission to manage (from react-native-permissions PERMISSIONS constants)
-  permission: Permission | "notifications";
+  permission: string;                // permission identifier (engine-specific)
+  engine?: PermissionEngine;         // optional — overrides global/fallback
 
-  // Pre-prompt shown BEFORE the system dialog
   prePrompt: {
     title: string;
     message: string;
-    confirmLabel?: string;   // default: "Continue"
-    cancelLabel?: string;    // default: "Not Now"
+    confirmLabel?: string;           // default: "Continue"
+    cancelLabel?: string;            // default: "Not Now"
   };
 
-  // Prompt shown when permission is permanently blocked
   blockedPrompt: {
     title: string;
     message: string;
-    settingsLabel?: string;  // default: "Open Settings"
+    settingsLabel?: string;          // default: "Open Settings"
   };
 
-  // Callbacks for analytics
+  // Callbacks
   onGrant?: () => void;
   onDeny?: () => void;
   onBlock?: () => void;
   onSettingsReturn?: (granted: boolean) => void;
 
   // Options
-  autoCheck?: boolean;            // default: true — check on mount
-  recheckOnForeground?: boolean;  // default: false
+  autoCheck?: boolean;               // default: true — check on mount
+  recheckOnForeground?: boolean;     // default: false
 }
 ```
 
@@ -150,7 +217,7 @@ The main hook. Manages the full permission lifecycle.
 ```typescript
 {
   state: PermissionFlowState;           // current state machine state
-  nativeStatus: PermissionStatus | null; // raw status from react-native-permissions
+  nativeStatus: PermissionStatus | null; // status from the engine
 
   // Convenience booleans
   isGranted: boolean;
@@ -160,7 +227,7 @@ The main hook. Manages the full permission lifecycle.
   isUnavailable: boolean;
 
   // Actions
-  request: () => void;      // confirm pre-prompt → fire system dialog
+  request: () => void;      // confirm pre-prompt -> fire system dialog
   check: () => void;        // manually re-check permission status
   dismiss: () => void;      // dismiss pre-prompt ("Not Now")
   openSettings: () => void; // open app settings for blocked permissions
@@ -172,7 +239,7 @@ The main hook. Manages the full permission lifecycle.
 ```tsx
 function CameraScreen() {
   const camera = usePermissionHandler({
-    permission: PERMISSIONS.IOS.CAMERA,
+    permission: Permissions.CAMERA,
     prePrompt: {
       title: "Camera Access",
       message: "We need your camera to scan QR codes.",
@@ -221,7 +288,7 @@ Orchestrates flows for features needing multiple permissions (e.g., video call =
 ```typescript
 {
   permissions: Array<{
-    permission: Permission | "notifications";
+    permission: string;
     prePrompt: PrePromptConfig;
     blockedPrompt: BlockedPromptConfig;
     onGrant?: () => void;
@@ -233,6 +300,8 @@ Orchestrates flows for features needing multiple permissions (e.g., video call =
   // sequential: ask one at a time, stop on denial/block
   // parallel: check all at once, then request denied ones
 
+  engine?: PermissionEngine;  // optional — overrides global/fallback
+  autoCheck?: boolean;        // default: true — check all on mount
   onAllGranted?: () => void;
 }
 ```
@@ -254,12 +323,12 @@ function VideoCallScreen() {
   const perms = useMultiplePermissions({
     permissions: [
       {
-        permission: PERMISSIONS.IOS.CAMERA,
+        permission: Permissions.CAMERA,
         prePrompt: { title: "Camera", message: "Needed for video." },
         blockedPrompt: { title: "Camera Blocked", message: "Enable in Settings." },
       },
       {
-        permission: PERMISSIONS.IOS.MICROPHONE,
+        permission: Permissions.MICROPHONE,
         prePrompt: { title: "Microphone", message: "Needed for audio." },
         blockedPrompt: { title: "Mic Blocked", message: "Enable in Settings." },
       },
@@ -284,7 +353,8 @@ Declarative component that renders children only when permission is granted.
 
 ```typescript
 {
-  permission: Permission | "notifications";
+  permission: string;
+  engine?: PermissionEngine;
   prePrompt: PrePromptConfig;
   blockedPrompt: BlockedPromptConfig;
   children: ReactNode;                    // shown when granted
@@ -294,7 +364,7 @@ Declarative component that renders children only when permission is granted.
   onBlock?: () => void;
   onSettingsReturn?: (granted: boolean) => void;
 
-  // Custom UI (optional — default modals are used if omitted)
+  // Custom UI (optional -- default modals are used if omitted)
   renderPrePrompt?: (props: {
     config: PrePromptConfig;
     onConfirm: () => void;
@@ -311,7 +381,7 @@ Declarative component that renders children only when permission is granted.
 
 ```tsx
 <PermissionGate
-  permission={PERMISSIONS.IOS.CAMERA}
+  permission={Permissions.CAMERA}
   prePrompt={{ title: "Camera", message: "We need camera access." }}
   blockedPrompt={{ title: "Blocked", message: "Enable in Settings." }}
   fallback={<LoadingSpinner />}
@@ -360,47 +430,136 @@ The raw state machine function. For advanced use cases where you want to build y
 import { transition } from "react-native-permission-handler";
 
 const next = transition("prePrompt", { type: "PRE_PROMPT_CONFIRM" });
-// → "requesting"
+// -> "requesting"
 ```
 
 Pure function, no side effects, no React dependency.
 
+---
+
+### `setDefaultEngine(engine)`
+
+Set a global default `PermissionEngine` for all hooks and components. Call once at app startup.
+
+```typescript
+import { setDefaultEngine } from "react-native-permission-handler";
+
+setDefaultEngine(myEngine);
+```
+
+---
+
+### `createRNPEngine()`
+
+Create an engine adapter for `react-native-permissions`. Handles notification routing internally.
+
+```typescript
+import { createRNPEngine } from "react-native-permission-handler/rnp";
+
+const engine = createRNPEngine();
+setDefaultEngine(engine);
+```
+
+You don't need to call this explicitly if `react-native-permissions` is installed — the library auto-creates it as a fallback.
+
+---
+
+### `Permissions` (cross-platform constants)
+
+The RNP entry point also exports cross-platform permission constants that resolve to the correct platform-specific string via `Platform.select`:
+
+```typescript
+import { Permissions } from "react-native-permission-handler/rnp";
+
+Permissions.CAMERA           // ios: "ios.permission.CAMERA", android: "android.permission.CAMERA"
+Permissions.MICROPHONE       // ios: "ios.permission.MICROPHONE", android: "android.permission.RECORD_AUDIO"
+Permissions.CONTACTS         // ios: "ios.permission.CONTACTS", android: "android.permission.READ_CONTACTS"
+Permissions.CALENDARS        // ios: "ios.permission.CALENDARS", android: "android.permission.READ_CALENDAR"
+Permissions.LOCATION_WHEN_IN_USE
+Permissions.LOCATION_ALWAYS
+Permissions.PHOTO_LIBRARY
+Permissions.PHOTO_LIBRARY_ADD_ONLY
+Permissions.BLUETOOTH
+Permissions.NOTIFICATIONS    // "notifications" (routed to notification-specific APIs by the engine)
+```
+
+For platform-specific permissions not in this map, pass the raw string directly (e.g., `"ios.permission.FACE_ID"`).
+
+---
+
+### `createExpoEngine(config)`
+
+Create an engine adapter for Expo permission modules. Pass a map of permission keys to Expo modules.
+
+```typescript
+import { createExpoEngine } from "react-native-permission-handler/expo";
+import * as Camera from "expo-camera";
+import * as Location from "expo-location";
+import * as Notifications from "expo-notifications";
+
+const engine = createExpoEngine({
+  permissions: {
+    camera: Camera,
+    location: Location,
+    notifications: Notifications,
+  },
+});
+
+setDefaultEngine(engine);
+```
+
+The adapter maps Expo's `{ status, canAskAgain }` response to the library's `PermissionStatus`:
+
+| Expo status | `canAskAgain` | Maps to |
+|---|---|---|
+| `"granted"` | — | `"granted"` |
+| `"undetermined"` | — | `"denied"` |
+| `"denied"` | `true` | `"denied"` |
+| `"denied"` | `false` | `"blocked"` |
+
+---
+
+### `PermissionEngine` interface
+
+Implement this to use any permissions backend:
+
+```typescript
+interface PermissionEngine {
+  check(permission: string): Promise<PermissionStatus>;
+  request(permission: string): Promise<PermissionStatus>;
+  openSettings(): Promise<void>;
+}
+
+type PermissionStatus = "granted" | "denied" | "blocked" | "limited" | "unavailable";
+```
+
+The engine is responsible for:
+- Mapping its native status values to the library's `PermissionStatus`
+- Handling special cases like notifications internally
+- Opening the correct settings screen
+
 ## Platform Notes
 
 **iOS:**
-- The system permission dialog can only be shown **once** per permission. If the user denies it, you can never show it again programmatically. This is why the pre-prompt is critical — it preserves the one-time system dialog.
+- The system permission dialog can only be shown **once** per permission. If the user denies it, you can never show it again programmatically. This is why the pre-prompt is critical.
 - `check()` returns `DENIED` for both "never asked" and "denied once" — both are still requestable.
 - `BLOCKED` means the user denied via the system dialog or disabled the permission in Settings.
 
 **Android:**
 - After 2 denials, Android 11+ auto-blocks the permission. No more system dialogs.
-- For notification permissions on Android 13+, `checkNotifications()` never returns `BLOCKED` — the library handles this by using `requestNotifications()` for accurate status.
+- For notification permissions on Android 13+, `checkNotifications()` never returns `BLOCKED` — the RNP engine handles this by using `requestNotifications()` for accurate status.
 
 **Notifications:**
-- Pass `"notifications"` as the permission identifier. The library automatically routes to `checkNotifications`/`requestNotifications` instead of `check`/`request`.
+- Pass `"notifications"` as the permission identifier. The RNP engine automatically routes to `checkNotifications`/`requestNotifications`. For Expo, map `"notifications"` to `expo-notifications` in the engine config.
 
 ## Requirements
 
 - React Native >= 0.76
 - React >= 18
-- `react-native-permissions` >= 4.0.0
-
-**Expo:** Add the config plugin to your `app.json`:
-
-```json
-{
-  "plugins": [
-    [
-      "react-native-permissions",
-      {
-        "iosPermissions": ["Camera", "Microphone", "LocationWhenInUse"]
-      }
-    ]
-  ]
-}
-```
-
-**Bare React Native:** Follow the [react-native-permissions setup guide](https://github.com/zoontek/react-native-permissions#setup).
+- One of:
+  - `react-native-permissions` >= 4.0.0 (auto-detected, no config needed)
+  - Expo permission modules (use `createExpoEngine`)
+  - Custom `PermissionEngine` implementation
 
 ## License
 

package/dist/chunk-EU3KPRTI.mjs

@@ -0,0 +1,81 @@
+import {
+  __esm,
+  __export
+} from "./chunk-NFEGQTCC.mjs";
+
+// src/engines/rnp.ts
+var rnp_exports = {};
+__export(rnp_exports, {
+  Permissions: () => Permissions,
+  createRNPEngine: () => createRNPEngine
+});
+import { Platform } from "react-native";
+import {
+  check,
+  checkNotifications,
+  openSettings,
+  request,
+  requestNotifications
+} from "react-native-permissions";
+function p(ios, android) {
+  return Platform.select({ ios, android, default: ios }) ?? ios;
+}
+function createRNPEngine() {
+  return {
+    async check(permission) {
+      if (permission === "notifications") {
+        const result = await checkNotifications();
+        return result.status;
+      }
+      return await check(permission);
+    },
+    async request(permission) {
+      if (permission === "notifications") {
+        const result = await requestNotifications(["alert", "badge", "sound"]);
+        return result.status;
+      }
+      return await request(permission);
+    },
+    async openSettings() {
+      await openSettings();
+    }
+  };
+}
+var Permissions;
+var init_rnp = __esm({
+  "src/engines/rnp.ts"() {
+    Permissions = {
+      CAMERA: p("ios.permission.CAMERA", "android.permission.CAMERA"),
+      MICROPHONE: p("ios.permission.MICROPHONE", "android.permission.RECORD_AUDIO"),
+      CONTACTS: p("ios.permission.CONTACTS", "android.permission.READ_CONTACTS"),
+      CALENDARS: p("ios.permission.CALENDARS", "android.permission.READ_CALENDAR"),
+      CALENDARS_WRITE_ONLY: p(
+        "ios.permission.CALENDARS_WRITE_ONLY",
+        "android.permission.WRITE_CALENDAR"
+      ),
+      LOCATION_WHEN_IN_USE: p(
+        "ios.permission.LOCATION_WHEN_IN_USE",
+        "android.permission.ACCESS_FINE_LOCATION"
+      ),
+      LOCATION_ALWAYS: p(
+        "ios.permission.LOCATION_ALWAYS",
+        "android.permission.ACCESS_BACKGROUND_LOCATION"
+      ),
+      PHOTO_LIBRARY: p("ios.permission.PHOTO_LIBRARY", "android.permission.READ_MEDIA_IMAGES"),
+      PHOTO_LIBRARY_ADD_ONLY: p(
+        "ios.permission.PHOTO_LIBRARY_ADD_ONLY",
+        "android.permission.WRITE_EXTERNAL_STORAGE"
+      ),
+      BLUETOOTH: p("ios.permission.BLUETOOTH", "android.permission.BLUETOOTH_CONNECT"),
+      NOTIFICATIONS: "notifications"
+    };
+  }
+});
+
+export {
+  Permissions,
+  createRNPEngine,
+  rnp_exports,
+  init_rnp
+};
+//# sourceMappingURL=chunk-EU3KPRTI.mjs.map

package/dist/chunk-EU3KPRTI.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/engines/rnp.ts"],"sourcesContent":["import { Platform } from \"react-native\";\nimport {\n  type Permission,\n  check,\n  checkNotifications,\n  openSettings,\n  request,\n  requestNotifications,\n} from \"react-native-permissions\";\nimport type { PermissionEngine, PermissionStatus } from \"../types\";\n\nfunction p(ios: string, android: string): string {\n  return Platform.select({ ios, android, default: ios }) ?? ios;\n}\n\n/**\n * Cross-platform permission constants for use with the RNP engine.\n * Each resolves to the correct platform-specific string at runtime.\n */\nexport const Permissions = {\n  CAMERA: p(\"ios.permission.CAMERA\", \"android.permission.CAMERA\"),\n  MICROPHONE: p(\"ios.permission.MICROPHONE\", \"android.permission.RECORD_AUDIO\"),\n  CONTACTS: p(\"ios.permission.CONTACTS\", \"android.permission.READ_CONTACTS\"),\n  CALENDARS: p(\"ios.permission.CALENDARS\", \"android.permission.READ_CALENDAR\"),\n  CALENDARS_WRITE_ONLY: p(\n    \"ios.permission.CALENDARS_WRITE_ONLY\",\n    \"android.permission.WRITE_CALENDAR\",\n  ),\n  LOCATION_WHEN_IN_USE: p(\n    \"ios.permission.LOCATION_WHEN_IN_USE\",\n    \"android.permission.ACCESS_FINE_LOCATION\",\n  ),\n  LOCATION_ALWAYS: p(\n    \"ios.permission.LOCATION_ALWAYS\",\n    \"android.permission.ACCESS_BACKGROUND_LOCATION\",\n  ),\n  PHOTO_LIBRARY: p(\"ios.permission.PHOTO_LIBRARY\", \"android.permission.READ_MEDIA_IMAGES\"),\n  PHOTO_LIBRARY_ADD_ONLY: p(\n    \"ios.permission.PHOTO_LIBRARY_ADD_ONLY\",\n    \"android.permission.WRITE_EXTERNAL_STORAGE\",\n  ),\n  BLUETOOTH: p(\"ios.permission.BLUETOOTH\", \"android.permission.BLUETOOTH_CONNECT\"),\n  NOTIFICATIONS: \"notifications\",\n} as const;\n\nexport function createRNPEngine(): PermissionEngine {\n  return {\n    async check(permission: string): Promise<PermissionStatus> {\n      if (permission === \"notifications\") {\n        const result = await checkNotifications();\n        return result.status as PermissionStatus;\n      }\n      return (await check(permission as Permission)) as PermissionStatus;\n    },\n\n    async request(permission: string): Promise<PermissionStatus> {\n      if (permission === \"notifications\") {\n        const result = await requestNotifications([\"alert\", \"badge\", \"sound\"]);\n        return result.status as PermissionStatus;\n      }\n      return (await request(permission as Permission)) as PermissionStatus;\n    },\n\n    async openSettings(): Promise<void> {\n      await openSettings();\n    },\n  };\n}\n"],"mappings":";;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,SAAS,gBAAgB;AACzB;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAS,EAAE,KAAa,SAAyB;AAC/C,SAAO,SAAS,OAAO,EAAE,KAAK,SAAS,SAAS,IAAI,CAAC,KAAK;AAC5D;AAgCO,SAAS,kBAAoC;AAClD,SAAO;AAAA,IACL,MAAM,MAAM,YAA+C;AACzD,UAAI,eAAe,iBAAiB;AAClC,cAAM,SAAS,MAAM,mBAAmB;AACxC,eAAO,OAAO;AAAA,MAChB;AACA,aAAQ,MAAM,MAAM,UAAwB;AAAA,IAC9C;AAAA,IAEA,MAAM,QAAQ,YAA+C;AAC3D,UAAI,eAAe,iBAAiB;AAClC,cAAM,SAAS,MAAM,qBAAqB,CAAC,SAAS,SAAS,OAAO,CAAC;AACrE,eAAO,OAAO;AAAA,MAChB;AACA,aAAQ,MAAM,QAAQ,UAAwB;AAAA,IAChD;AAAA,IAEA,MAAM,eAA8B;AAClC,YAAM,aAAa;AAAA,IACrB;AAAA,EACF;AACF;AAnEA,IAmBa;AAnBb;AAAA;AAmBO,IAAM,cAAc;AAAA,MACzB,QAAQ,EAAE,yBAAyB,2BAA2B;AAAA,MAC9D,YAAY,EAAE,6BAA6B,iCAAiC;AAAA,MAC5E,UAAU,EAAE,2BAA2B,kCAAkC;AAAA,MACzE,WAAW,EAAE,4BAA4B,kCAAkC;AAAA,MAC3E,sBAAsB;AAAA,QACpB;AAAA,QACA;AAAA,MACF;AAAA,MACA,sBAAsB;AAAA,QACpB;AAAA,QACA;AAAA,MACF;AAAA,MACA,iBAAiB;AAAA,QACf;AAAA,QACA;AAAA,MACF;AAAA,MACA,eAAe,EAAE,gCAAgC,sCAAsC;AAAA,MACvF,wBAAwB;AAAA,QACtB;AAAA,QACA;AAAA,MACF;AAAA,MACA,WAAW,EAAE,4BAA4B,sCAAsC;AAAA,MAC/E,eAAe;AAAA,IACjB;AAAA;AAAA;","names":[]}

package/dist/chunk-NFEGQTCC.mjs

@@ -0,0 +1,27 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+export {
+  __esm,
+  __export,
+  __toCommonJS
+};
+//# sourceMappingURL=chunk-NFEGQTCC.mjs.map

package/dist/chunk-NFEGQTCC.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/engines/expo.d.mts

@@ -0,0 +1,18 @@
+import { P as PermissionEngine } from '../types-QXyq8VnD.mjs';
+
+interface ExpoPermissionModule {
+    getPermissionsAsync: () => Promise<{
+        status: string;
+        canAskAgain: boolean;
+    }>;
+    requestPermissionsAsync: () => Promise<{
+        status: string;
+        canAskAgain: boolean;
+    }>;
+}
+interface ExpoEngineConfig {
+    permissions: Record<string, ExpoPermissionModule>;
+}
+declare function createExpoEngine(config: ExpoEngineConfig): PermissionEngine;
+
+export { type ExpoEngineConfig, type ExpoPermissionModule, createExpoEngine };

package/dist/engines/expo.d.ts

@@ -0,0 +1,18 @@
+import { P as PermissionEngine } from '../types-QXyq8VnD.js';
+
+interface ExpoPermissionModule {
+    getPermissionsAsync: () => Promise<{
+        status: string;
+        canAskAgain: boolean;
+    }>;
+    requestPermissionsAsync: () => Promise<{
+        status: string;
+        canAskAgain: boolean;
+    }>;
+}
+interface ExpoEngineConfig {
+    permissions: Record<string, ExpoPermissionModule>;
+}
+declare function createExpoEngine(config: ExpoEngineConfig): PermissionEngine;
+
+export { type ExpoEngineConfig, type ExpoPermissionModule, createExpoEngine };

package/dist/engines/expo.js

@@ -0,0 +1,58 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/engines/expo.ts
+var expo_exports = {};
+__export(expo_exports, {
+  createExpoEngine: () => createExpoEngine
+});
+module.exports = __toCommonJS(expo_exports);
+var import_react_native = require("react-native");
+function mapExpoStatus(result) {
+  if (result.status === "granted") return "granted";
+  if (result.status === "undetermined") return "denied";
+  if (result.status === "denied") {
+    return result.canAskAgain ? "denied" : "blocked";
+  }
+  return "unavailable";
+}
+function createExpoEngine(config) {
+  return {
+    async check(permission) {
+      const mod = config.permissions[permission];
+      if (!mod) return "unavailable";
+      const result = await mod.getPermissionsAsync();
+      return mapExpoStatus(result);
+    },
+    async request(permission) {
+      const mod = config.permissions[permission];
+      if (!mod) return "unavailable";
+      const result = await mod.requestPermissionsAsync();
+      return mapExpoStatus(result);
+    },
+    async openSettings() {
+      await import_react_native.Linking.openSettings();
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createExpoEngine
+});
+//# sourceMappingURL=expo.js.map

package/dist/engines/expo.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/engines/expo.ts"],"sourcesContent":["import { Linking } from \"react-native\";\nimport type { PermissionEngine, PermissionStatus } from \"../types\";\n\nexport interface ExpoPermissionModule {\n  getPermissionsAsync: () => Promise<{ status: string; canAskAgain: boolean }>;\n  requestPermissionsAsync: () => Promise<{ status: string; canAskAgain: boolean }>;\n}\n\nexport interface ExpoEngineConfig {\n  permissions: Record<string, ExpoPermissionModule>;\n}\n\nfunction mapExpoStatus(result: {\n  status: string;\n  canAskAgain: boolean;\n}): PermissionStatus {\n  if (result.status === \"granted\") return \"granted\";\n  if (result.status === \"undetermined\") return \"denied\";\n  if (result.status === \"denied\") {\n    return result.canAskAgain ? \"denied\" : \"blocked\";\n  }\n  return \"unavailable\";\n}\n\nexport function createExpoEngine(config: ExpoEngineConfig): PermissionEngine {\n  return {\n    async check(permission: string): Promise<PermissionStatus> {\n      const mod = config.permissions[permission];\n      if (!mod) return \"unavailable\";\n      const result = await mod.getPermissionsAsync();\n      return mapExpoStatus(result);\n    },\n\n    async request(permission: string): Promise<PermissionStatus> {\n      const mod = config.permissions[permission];\n      if (!mod) return \"unavailable\";\n      const result = await mod.requestPermissionsAsync();\n      return mapExpoStatus(result);\n    },\n\n    async openSettings(): Promise<void> {\n      await Linking.openSettings();\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0BAAwB;AAYxB,SAAS,cAAc,QAGF;AACnB,MAAI,OAAO,WAAW,UAAW,QAAO;AACxC,MAAI,OAAO,WAAW,eAAgB,QAAO;AAC7C,MAAI,OAAO,WAAW,UAAU;AAC9B,WAAO,OAAO,cAAc,WAAW;AAAA,EACzC;AACA,SAAO;AACT;AAEO,SAAS,iBAAiB,QAA4C;AAC3E,SAAO;AAAA,IACL,MAAM,MAAM,YAA+C;AACzD,YAAM,MAAM,OAAO,YAAY,UAAU;AACzC,UAAI,CAAC,IAAK,QAAO;AACjB,YAAM,SAAS,MAAM,IAAI,oBAAoB;AAC7C,aAAO,cAAc,MAAM;AAAA,IAC7B;AAAA,IAEA,MAAM,QAAQ,YAA+C;AAC3D,YAAM,MAAM,OAAO,YAAY,UAAU;AACzC,UAAI,CAAC,IAAK,QAAO;AACjB,YAAM,SAAS,MAAM,IAAI,wBAAwB;AACjD,aAAO,cAAc,MAAM;AAAA,IAC7B;AAAA,IAEA,MAAM,eAA8B;AAClC,YAAM,4BAAQ,aAAa;AAAA,IAC7B;AAAA,EACF;AACF;","names":[]}