react-native-permission-handler 0.2.0 → 0.3.0

package/dist/index.js

@@ -23,8 +23,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/engines/rnp.ts
 var rnp_exports = {};
 __export(rnp_exports, {
+  Permissions: () => Permissions,
   createRNPEngine: () => createRNPEngine
 });
+function p(ios, android) {
+  return import_react_native.Platform.select({ ios, android, default: ios }) ?? ios;
+}
 function createRNPEngine() {
   return {
     async check(permission) {
@@ -46,11 +50,37 @@ function createRNPEngine() {
     }
   };
 }
-var import_react_native_permissions;
+var import_react_native, import_react_native_permissions, Permissions;
 var init_rnp = __esm({
   "src/engines/rnp.ts"() {
     "use strict";
+    import_react_native = require("react-native");
     import_react_native_permissions = require("react-native-permissions");
+    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"
+    };
   }
 });
 
@@ -153,7 +183,56 @@ function transition(state, event) {
 
 // src/hooks/use-permission-handler.ts
 var import_react = require("react");
-var import_react_native = require("react-native");
+var import_react_native2 = require("react-native");
+
+// src/core/debug-logger.ts
+var PREFIX = "[permission-handler]";
+var NOOP_LOGGER = {
+  transition: () => {
+  },
+  info: () => {
+  }
+};
+function createDebugLogger(debug, permission) {
+  if (!debug) return NOOP_LOGGER;
+  const log = typeof debug === "function" ? debug : (msg) => console.log(msg);
+  return {
+    transition(from, to, event) {
+      log(`${PREFIX} ${permission}: ${from} \u2192 ${to}${event ? ` (${event})` : ""}`);
+    },
+    info(msg) {
+      log(`${PREFIX} ${permission}: ${msg}`);
+    }
+  };
+}
+
+// src/core/with-timeout.ts
+var PermissionTimeoutError = class extends Error {
+  constructor(permission, timeoutMs) {
+    super(`Permission request for "${permission}" timed out after ${timeoutMs}ms`);
+    this.name = "PermissionTimeoutError";
+    this.permission = permission;
+    this.timeoutMs = timeoutMs;
+  }
+};
+function withTimeout(promise, timeoutMs, permission) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(
+      () => reject(new PermissionTimeoutError(permission, timeoutMs)),
+      timeoutMs
+    );
+    promise.then(
+      (val) => {
+        clearTimeout(timer);
+        resolve(val);
+      },
+      (err) => {
+        clearTimeout(timer);
+        reject(err);
+      }
+    );
+  });
+}
 
 // src/engines/rnp-fallback.ts
 var cachedFallback = null;
@@ -186,48 +265,84 @@ function usePermissionHandler(config) {
   const [nativeStatus, setNativeStatus] = (0, import_react.useState)(null);
   const isRequesting = (0, import_react.useRef)(false);
   const waitingForSettings = (0, import_react.useRef)(false);
-  const appStateRef = (0, import_react.useRef)(import_react_native.AppState.currentState);
-  const { permission, autoCheck = true, onGrant, onDeny, onBlock, onSettingsReturn } = config;
+  const appStateRef = (0, import_react.useRef)(import_react_native2.AppState.currentState);
+  const {
+    permission,
+    autoCheck = true,
+    requestTimeout,
+    onTimeout,
+    debug,
+    onGrant,
+    onDeny,
+    onBlock,
+    onSettingsReturn
+  } = config;
+  const logger = createDebugLogger(debug, permission);
   const checkPermission = (0, import_react.useCallback)(async () => {
-    setFlowState((s) => transition(s, { type: "CHECK" }));
+    setFlowState((s) => {
+      const next = transition(s, { type: "CHECK" });
+      logger.transition(s, next, "CHECK");
+      return next;
+    });
     try {
       const status = await engine.check(permission);
       setNativeStatus(status);
       setFlowState((s) => {
         const next = transition(s, { type: "CHECK_RESULT", status });
+        logger.transition(s, next, `CHECK_RESULT:${status}`);
         if (next === "granted" && s !== "granted") onGrant?.();
         return next;
       });
     } catch {
       setFlowState("idle");
     }
-  }, [engine, permission, onGrant]);
+  }, [engine, permission, logger, onGrant]);
   const requestPermission = (0, import_react.useCallback)(async () => {
     if (isRequesting.current) return;
     isRequesting.current = true;
-    setFlowState((s) => transition(s, { type: "PRE_PROMPT_CONFIRM" }));
+    setFlowState((s) => {
+      const next = transition(s, { type: "PRE_PROMPT_CONFIRM" });
+      logger.transition(s, next, "PRE_PROMPT_CONFIRM");
+      return next;
+    });
     try {
-      const status = await engine.request(permission);
+      const requestPromise = engine.request(permission);
+      const status = requestTimeout ? await withTimeout(requestPromise, requestTimeout, permission) : await requestPromise;
       setNativeStatus(status);
       setFlowState((s) => {
         const next = transition(s, { type: "REQUEST_RESULT", status });
+        logger.transition(s, next, `REQUEST_RESULT:${status}`);
         if (next === "granted") onGrant?.();
         if (next === "denied") onDeny?.();
         if (next === "blockedPrompt") onBlock?.();
         return next;
       });
-    } catch {
-      setFlowState("denied");
+    } catch (err) {
+      if (err instanceof PermissionTimeoutError) {
+        logger.info(`request timed out after ${requestTimeout}ms`);
+        onTimeout?.();
+        setFlowState("blockedPrompt");
+      } else {
+        setFlowState("denied");
+      }
     } finally {
       isRequesting.current = false;
     }
-  }, [engine, permission, onGrant, onDeny, onBlock]);
+  }, [engine, permission, requestTimeout, onTimeout, logger, onGrant, onDeny, onBlock]);
   const dismiss = (0, import_react.useCallback)(() => {
-    setFlowState((s) => transition(s, { type: "PRE_PROMPT_DISMISS" }));
+    setFlowState((s) => {
+      const next = transition(s, { type: "PRE_PROMPT_DISMISS" });
+      logger.transition(s, next, "PRE_PROMPT_DISMISS");
+      return next;
+    });
     onDeny?.();
-  }, [onDeny]);
+  }, [logger, onDeny]);
   const goToSettings = (0, import_react.useCallback)(async () => {
-    setFlowState((s) => transition(s, { type: "OPEN_SETTINGS" }));
+    setFlowState((s) => {
+      const next = transition(s, { type: "OPEN_SETTINGS" });
+      logger.transition(s, next, "OPEN_SETTINGS");
+      return next;
+    });
     waitingForSettings.current = true;
     try {
       await engine.openSettings();
@@ -235,14 +350,19 @@ function usePermissionHandler(config) {
       waitingForSettings.current = false;
       setFlowState("blockedPrompt");
     }
-  }, [engine]);
+  }, [engine, logger]);
   const recheckAfterSettings = (0, import_react.useCallback)(async () => {
-    setFlowState((s) => transition(s, { type: "SETTINGS_RETURN" }));
+    setFlowState((s) => {
+      const next = transition(s, { type: "SETTINGS_RETURN" });
+      logger.transition(s, next, "SETTINGS_RETURN");
+      return next;
+    });
     try {
       const status = await engine.check(permission);
       setNativeStatus(status);
       setFlowState((s) => {
         const next = transition(s, { type: "RECHECK_RESULT", status });
+        logger.transition(s, next, `RECHECK_RESULT:${status}`);
         if (next === "granted") onGrant?.();
         onSettingsReturn?.(next === "granted");
         return next;
@@ -250,14 +370,14 @@ function usePermissionHandler(config) {
     } catch {
       setFlowState("blockedPrompt");
     }
-  }, [engine, permission, onGrant, onSettingsReturn]);
+  }, [engine, permission, logger, onGrant, onSettingsReturn]);
   (0, import_react.useEffect)(() => {
     if (autoCheck) {
       checkPermission();
     }
   }, []);
   (0, import_react.useEffect)(() => {
-    const subscription = import_react_native.AppState.addEventListener("change", (nextAppState) => {
+    const subscription = import_react_native2.AppState.addEventListener("change", (nextAppState) => {
       if (appStateRef.current.match(/inactive|background/) && nextAppState === "active" && waitingForSettings.current) {
         waitingForSettings.current = false;
         recheckAfterSettings();
@@ -306,7 +426,16 @@ function statusToFlowState(status) {
 }
 function useMultiplePermissions(config) {
   const engine = resolveEngine(config.engine);
-  const { permissions, strategy, autoCheck = true, onAllGranted } = config;
+  const {
+    permissions,
+    strategy,
+    autoCheck = true,
+    requestTimeout,
+    onTimeout,
+    debug,
+    onAllGranted
+  } = config;
+  const logger = createDebugLogger(debug, "multi");
   const [statuses, setStatuses] = (0, import_react2.useState)(() => {
     const initial = {};
     for (const entry of permissions) {
@@ -320,13 +449,16 @@ function useMultiplePermissions(config) {
     if (isRunning.current) return;
     isRunning.current = true;
     const update = (key, state) => {
-      setStatuses((prev) => ({ ...prev, [key]: state }));
+      setStatuses((prev) => {
+        logger.transition(prev[key] ?? "idle", state, key);
+        return { ...prev, [key]: state };
+      });
     };
     try {
       if (strategy === "sequential") {
-        await runSequential(permissions, engine, update);
+        await runSequential(permissions, engine, update, requestTimeout, onTimeout);
       } else {
-        await runParallel(permissions, engine, update);
+        await runParallel(permissions, engine, update, requestTimeout, onTimeout);
       }
       let allDone = true;
       for (const entry of permissions) {
@@ -342,7 +474,7 @@ function useMultiplePermissions(config) {
     } finally {
       isRunning.current = false;
     }
-  }, [permissions, strategy, engine, onAllGranted]);
+  }, [permissions, strategy, engine, requestTimeout, onTimeout, logger, onAllGranted]);
   (0, import_react2.useEffect)(() => {
     if (!autoCheck) return;
     let cancelled = false;
@@ -365,7 +497,7 @@ function useMultiplePermissions(config) {
     request: requestAll
   };
 }
-async function runSequential(permissions, engine, updateStatus) {
+async function runSequential(permissions, engine, updateStatus, requestTimeout, onTimeout) {
   for (const entry of permissions) {
     const key = permissionKey(entry);
     updateStatus(key, "checking");
@@ -385,22 +517,32 @@ async function runSequential(permissions, engine, updateStatus) {
       break;
     }
     updateStatus(key, "requesting");
-    const requestStatus = await engine.request(entry.permission);
-    if (isGrantedStatus(requestStatus)) {
-      updateStatus(key, "granted");
-      entry.onGrant?.();
-    } else if (requestStatus === "blocked") {
-      updateStatus(key, "blockedPrompt");
-      entry.onBlock?.();
-      break;
-    } else {
-      updateStatus(key, "denied");
-      entry.onDeny?.();
-      break;
+    try {
+      const requestPromise = engine.request(entry.permission);
+      const requestStatus = requestTimeout ? await withTimeout(requestPromise, requestTimeout, entry.permission) : await requestPromise;
+      if (isGrantedStatus(requestStatus)) {
+        updateStatus(key, "granted");
+        entry.onGrant?.();
+      } else if (requestStatus === "blocked") {
+        updateStatus(key, "blockedPrompt");
+        entry.onBlock?.();
+        break;
+      } else {
+        updateStatus(key, "denied");
+        entry.onDeny?.();
+        break;
+      }
+    } catch (err) {
+      if (err instanceof PermissionTimeoutError) {
+        onTimeout?.();
+        updateStatus(key, "blockedPrompt");
+        break;
+      }
+      throw err;
     }
   }
 }
-async function runParallel(permissions, engine, updateStatus) {
+async function runParallel(permissions, engine, updateStatus, requestTimeout, onTimeout) {
   const checkResults = await Promise.all(
     permissions.map(async (entry) => {
       const key = permissionKey(entry);
@@ -427,22 +569,32 @@ async function runParallel(permissions, engine, updateStatus) {
       continue;
     }
     updateStatus(key, "requesting");
-    const requestStatus = await engine.request(entry.permission);
-    if (isGrantedStatus(requestStatus)) {
-      updateStatus(key, "granted");
-      entry.onGrant?.();
-    } else if (requestStatus === "blocked") {
-      updateStatus(key, "blockedPrompt");
-      entry.onBlock?.();
-    } else {
-      updateStatus(key, "denied");
-      entry.onDeny?.();
+    try {
+      const requestPromise = engine.request(entry.permission);
+      const requestStatus = requestTimeout ? await withTimeout(requestPromise, requestTimeout, entry.permission) : await requestPromise;
+      if (isGrantedStatus(requestStatus)) {
+        updateStatus(key, "granted");
+        entry.onGrant?.();
+      } else if (requestStatus === "blocked") {
+        updateStatus(key, "blockedPrompt");
+        entry.onBlock?.();
+      } else {
+        updateStatus(key, "denied");
+        entry.onDeny?.();
+      }
+    } catch (err) {
+      if (err instanceof PermissionTimeoutError) {
+        onTimeout?.();
+        updateStatus(key, "blockedPrompt");
+      } else {
+        throw err;
+      }
     }
   }
 }
 
 // src/components/default-blocked-prompt.tsx
-var import_react_native2 = require("react-native");
+var import_react_native3 = require("react-native");
 var import_jsx_runtime = require("react/jsx-runtime");
 function DefaultBlockedPrompt({
   visible,
@@ -451,21 +603,21 @@ function DefaultBlockedPrompt({
   settingsLabel = "Open Settings",
   onOpenSettings
 }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.Modal, { visible, transparent: true, animationType: "fade", children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.View, { style: styles.overlay, children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_react_native2.View, { style: styles.modal, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.Text, { style: styles.title, children: title }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.Text, { style: styles.message, children: message }),
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native3.Modal, { visible, transparent: true, animationType: "fade", children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native3.View, { style: styles.overlay, children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_react_native3.View, { style: styles.modal, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native3.Text, { style: styles.title, children: title }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native3.Text, { style: styles.message, children: message }),
     /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-      import_react_native2.TouchableOpacity,
+      import_react_native3.TouchableOpacity,
       {
         style: styles.settingsButton,
         onPress: onOpenSettings,
         accessibilityRole: "button",
-        children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.Text, { style: styles.settingsText, children: settingsLabel })
+        children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native3.Text, { style: styles.settingsText, children: settingsLabel })
       }
     )
   ] }) }) });
 }
-var styles = import_react_native2.StyleSheet.create({
+var styles = import_react_native3.StyleSheet.create({
   overlay: {
     flex: 1,
     backgroundColor: "rgba(0,0,0,0.5)",
@@ -508,7 +660,7 @@ var styles = import_react_native2.StyleSheet.create({
 });
 
 // src/components/default-pre-prompt.tsx
-var import_react_native3 = require("react-native");
+var import_react_native4 = require("react-native");
 var import_jsx_runtime2 = require("react/jsx-runtime");
 function DefaultPrePrompt({
   visible,
@@ -519,22 +671,22 @@ function DefaultPrePrompt({
   onConfirm,
   onCancel
 }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native3.Modal, { visible, transparent: true, animationType: "fade", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native3.View, { style: styles2.overlay, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_react_native3.View, { style: styles2.modal, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native3.Text, { style: styles2.title, children: title }),
-    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native3.Text, { style: styles2.message, children: message }),
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native4.Modal, { visible, transparent: true, animationType: "fade", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native4.View, { style: styles2.overlay, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_react_native4.View, { style: styles2.modal, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native4.Text, { style: styles2.title, children: title }),
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native4.Text, { style: styles2.message, children: message }),
     /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
-      import_react_native3.TouchableOpacity,
+      import_react_native4.TouchableOpacity,
       {
         style: styles2.confirmButton,
         onPress: onConfirm,
         accessibilityRole: "button",
-        children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native3.Text, { style: styles2.confirmText, children: confirmLabel })
+        children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native4.Text, { style: styles2.confirmText, children: confirmLabel })
       }
     ),
-    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native3.TouchableOpacity, { onPress: onCancel, accessibilityRole: "button", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native3.Text, { style: styles2.cancelText, children: cancelLabel }) })
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native4.TouchableOpacity, { onPress: onCancel, accessibilityRole: "button", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native4.Text, { style: styles2.cancelText, children: cancelLabel }) })
   ] }) }) });
 }
-var styles2 = import_react_native3.StyleSheet.create({
+var styles2 = import_react_native4.StyleSheet.create({
   overlay: {
     flex: 1,
     backgroundColor: "rgba(0,0,0,0.5)",