react-native-permission-handler 0.1.0 → 0.2.1

package/dist/engines/expo.mjs

@@ -0,0 +1,35 @@
+import "../chunk-NFEGQTCC.mjs";
+
+// src/engines/expo.ts
+import { Linking } from "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 Linking.openSettings();
+    }
+  };
+}
+export {
+  createExpoEngine
+};
+//# sourceMappingURL=expo.mjs.map

package/dist/engines/expo.mjs.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,SAAS,eAAe;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,QAAQ,aAAa;AAAA,IAC7B;AAAA,EACF;AACF;","names":[]}

package/dist/engines/rnp.d.mts

@@ -0,0 +1,22 @@
+import { P as PermissionEngine } from '../types-QXyq8VnD.mjs';
+
+/**
+ * Cross-platform permission constants for use with the RNP engine.
+ * Each resolves to the correct platform-specific string at runtime.
+ */
+declare const Permissions: {
+    readonly CAMERA: string;
+    readonly MICROPHONE: string;
+    readonly CONTACTS: string;
+    readonly CALENDARS: string;
+    readonly CALENDARS_WRITE_ONLY: string;
+    readonly LOCATION_WHEN_IN_USE: string;
+    readonly LOCATION_ALWAYS: string;
+    readonly PHOTO_LIBRARY: string;
+    readonly PHOTO_LIBRARY_ADD_ONLY: string;
+    readonly BLUETOOTH: string;
+    readonly NOTIFICATIONS: "notifications";
+};
+declare function createRNPEngine(): PermissionEngine;
+
+export { Permissions, createRNPEngine };

package/dist/engines/rnp.d.ts

@@ -0,0 +1,22 @@
+import { P as PermissionEngine } from '../types-QXyq8VnD.js';
+
+/**
+ * Cross-platform permission constants for use with the RNP engine.
+ * Each resolves to the correct platform-specific string at runtime.
+ */
+declare const Permissions: {
+    readonly CAMERA: string;
+    readonly MICROPHONE: string;
+    readonly CONTACTS: string;
+    readonly CALENDARS: string;
+    readonly CALENDARS_WRITE_ONLY: string;
+    readonly LOCATION_WHEN_IN_USE: string;
+    readonly LOCATION_ALWAYS: string;
+    readonly PHOTO_LIBRARY: string;
+    readonly PHOTO_LIBRARY_ADD_ONLY: string;
+    readonly BLUETOOTH: string;
+    readonly NOTIFICATIONS: "notifications";
+};
+declare function createRNPEngine(): PermissionEngine;
+
+export { Permissions, createRNPEngine };

package/dist/engines/rnp.js

@@ -0,0 +1,83 @@
+"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/rnp.ts
+var rnp_exports = {};
+__export(rnp_exports, {
+  Permissions: () => Permissions,
+  createRNPEngine: () => createRNPEngine
+});
+module.exports = __toCommonJS(rnp_exports);
+var import_react_native = require("react-native");
+var import_react_native_permissions = require("react-native-permissions");
+function p(ios, android) {
+  return import_react_native.Platform.select({ ios, android, default: ios }) ?? ios;
+}
+var 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"
+};
+function createRNPEngine() {
+  return {
+    async check(permission) {
+      if (permission === "notifications") {
+        const result = await (0, import_react_native_permissions.checkNotifications)();
+        return result.status;
+      }
+      return await (0, import_react_native_permissions.check)(permission);
+    },
+    async request(permission) {
+      if (permission === "notifications") {
+        const result = await (0, import_react_native_permissions.requestNotifications)(["alert", "badge", "sound"]);
+        return result.status;
+      }
+      return await (0, import_react_native_permissions.request)(permission);
+    },
+    async openSettings() {
+      await (0, import_react_native_permissions.openSettings)();
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Permissions,
+  createRNPEngine
+});
+//# sourceMappingURL=rnp.js.map

package/dist/engines/rnp.js.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;AAAA,0BAAyB;AACzB,sCAOO;AAGP,SAAS,EAAE,KAAa,SAAyB;AAC/C,SAAO,6BAAS,OAAO,EAAE,KAAK,SAAS,SAAS,IAAI,CAAC,KAAK;AAC5D;AAMO,IAAM,cAAc;AAAA,EACzB,QAAQ,EAAE,yBAAyB,2BAA2B;AAAA,EAC9D,YAAY,EAAE,6BAA6B,iCAAiC;AAAA,EAC5E,UAAU,EAAE,2BAA2B,kCAAkC;AAAA,EACzE,WAAW,EAAE,4BAA4B,kCAAkC;AAAA,EAC3E,sBAAsB;AAAA,IACpB;AAAA,IACA;AAAA,EACF;AAAA,EACA,sBAAsB;AAAA,IACpB;AAAA,IACA;AAAA,EACF;AAAA,EACA,iBAAiB;AAAA,IACf;AAAA,IACA;AAAA,EACF;AAAA,EACA,eAAe,EAAE,gCAAgC,sCAAsC;AAAA,EACvF,wBAAwB;AAAA,IACtB;AAAA,IACA;AAAA,EACF;AAAA,EACA,WAAW,EAAE,4BAA4B,sCAAsC;AAAA,EAC/E,eAAe;AACjB;AAEO,SAAS,kBAAoC;AAClD,SAAO;AAAA,IACL,MAAM,MAAM,YAA+C;AACzD,UAAI,eAAe,iBAAiB;AAClC,cAAM,SAAS,UAAM,oDAAmB;AACxC,eAAO,OAAO;AAAA,MAChB;AACA,aAAQ,UAAM,uCAAM,UAAwB;AAAA,IAC9C;AAAA,IAEA,MAAM,QAAQ,YAA+C;AAC3D,UAAI,eAAe,iBAAiB;AAClC,cAAM,SAAS,UAAM,sDAAqB,CAAC,SAAS,SAAS,OAAO,CAAC;AACrE,eAAO,OAAO;AAAA,MAChB;AACA,aAAQ,UAAM,yCAAQ,UAAwB;AAAA,IAChD;AAAA,IAEA,MAAM,eAA8B;AAClC,gBAAM,8CAAa;AAAA,IACrB;AAAA,EACF;AACF;","names":[]}

package/dist/engines/rnp.mjs

@@ -0,0 +1,12 @@
+import {
+  Permissions,
+  createRNPEngine,
+  init_rnp
+} from "../chunk-EU3KPRTI.mjs";
+import "../chunk-NFEGQTCC.mjs";
+init_rnp();
+export {
+  Permissions,
+  createRNPEngine
+};
+//# sourceMappingURL=rnp.mjs.map

package/dist/engines/rnp.mjs.map

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

package/dist/index.d.mts

@@ -1,110 +1,9 @@
-import { Permission, PermissionStatus } from 'react-native-permissions';
+import { P as PermissionEngine, a as PermissionFlowState, b as PermissionFlowEvent, c as PermissionHandlerConfig, d as PermissionHandlerResult, M as MultiplePermissionsConfig, e as MultiplePermissionsResult, f as PermissionCallbacks, g as PrePromptConfig, B as BlockedPromptConfig } from './types-QXyq8VnD.mjs';
+export { h as MultiPermissionEntry, i as PermissionStatus } from './types-QXyq8VnD.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 
-/**
- * States of the permission flow state machine.
- */
-type PermissionFlowState = "idle" | "checking" | "prePrompt" | "requesting" | "granted" | "denied" | "blocked" | "blockedPrompt" | "openingSettings" | "recheckingAfterSettings" | "unavailable";
-/**
- * Events that drive state transitions.
- */
-type PermissionFlowEvent = {
-    type: "CHECK";
-} | {
-    type: "CHECK_RESULT";
-    status: PermissionStatus;
-} | {
-    type: "PRE_PROMPT_CONFIRM";
-} | {
-    type: "PRE_PROMPT_DISMISS";
-} | {
-    type: "REQUEST_RESULT";
-    status: PermissionStatus;
-} | {
-    type: "OPEN_SETTINGS";
-} | {
-    type: "SETTINGS_RETURN";
-} | {
-    type: "RECHECK_RESULT";
-    status: PermissionStatus;
-};
-/**
- * Configuration for the pre-prompt modal.
- */
-interface PrePromptConfig {
-    title: string;
-    message: string;
-    confirmLabel?: string;
-    cancelLabel?: string;
-}
-/**
- * Configuration for the blocked-prompt modal.
- */
-interface BlockedPromptConfig {
-    title: string;
-    message: string;
-    settingsLabel?: string;
-}
-/**
- * Callbacks for analytics and side effects.
- */
-interface PermissionCallbacks {
-    onGrant?: () => void;
-    onDeny?: () => void;
-    onBlock?: () => void;
-    onSettingsReturn?: (granted: boolean) => void;
-}
-/**
- * Configuration for usePermissionHandler.
- */
-interface PermissionHandlerConfig extends PermissionCallbacks {
-    permission: Permission | "notifications";
-    prePrompt: PrePromptConfig;
-    blockedPrompt: BlockedPromptConfig;
-    autoCheck?: boolean;
-    recheckOnForeground?: boolean;
-}
-/**
- * Return type of usePermissionHandler.
- */
-interface PermissionHandlerResult {
-    state: PermissionFlowState;
-    nativeStatus: PermissionStatus | null;
-    isGranted: boolean;
-    isDenied: boolean;
-    isBlocked: boolean;
-    isChecking: boolean;
-    isUnavailable: boolean;
-    request: () => void;
-    check: () => void;
-    dismiss: () => void;
-    openSettings: () => void;
-}
-/**
- * Configuration for a single permission within useMultiplePermissions.
- */
-interface MultiPermissionEntry extends PermissionCallbacks {
-    permission: Permission | "notifications";
-    prePrompt: PrePromptConfig;
-    blockedPrompt: BlockedPromptConfig;
-}
-/**
- * Configuration for useMultiplePermissions.
- */
-interface MultiplePermissionsConfig {
-    permissions: MultiPermissionEntry[];
-    strategy: "sequential" | "parallel";
-    onAllGranted?: () => void;
-}
-/**
- * Return type of useMultiplePermissions.
- */
-interface MultiplePermissionsResult {
-    statuses: Record<string, PermissionFlowState>;
-    allGranted: boolean;
-    request: () => void;
-}
+declare function setDefaultEngine(engine: PermissionEngine): void;
 
 declare function transition(state: PermissionFlowState, event: PermissionFlowEvent): PermissionFlowState;
 
@@ -113,7 +12,8 @@ declare function usePermissionHandler(config: PermissionHandlerConfig): Permissi
 declare function useMultiplePermissions(config: MultiplePermissionsConfig): MultiplePermissionsResult;
 
 interface PermissionGateProps extends PermissionCallbacks {
-    permission: Permission | "notifications";
+    permission: string;
+    engine?: PermissionEngine;
     prePrompt: PrePromptConfig;
     blockedPrompt: BlockedPromptConfig;
     children: ReactNode;
@@ -128,7 +28,7 @@ interface PermissionGateProps extends PermissionCallbacks {
         onOpenSettings: () => void;
     }) => ReactNode;
 }
-declare function PermissionGate({ permission, prePrompt, blockedPrompt, children, fallback, renderPrePrompt, renderBlockedPrompt, onGrant, onDeny, onBlock, onSettingsReturn, }: PermissionGateProps): react_jsx_runtime.JSX.Element;
+declare function PermissionGate({ permission, engine, prePrompt, blockedPrompt, children, fallback, renderPrePrompt, renderBlockedPrompt, onGrant, onDeny, onBlock, onSettingsReturn, }: PermissionGateProps): react_jsx_runtime.JSX.Element;
 
 interface DefaultPrePromptProps extends PrePromptConfig {
     visible: boolean;
@@ -143,4 +43,4 @@ interface DefaultBlockedPromptProps extends BlockedPromptConfig {
 }
 declare function DefaultBlockedPrompt({ visible, title, message, settingsLabel, onOpenSettings, }: DefaultBlockedPromptProps): react_jsx_runtime.JSX.Element;
 
-export { type BlockedPromptConfig, DefaultBlockedPrompt, type DefaultBlockedPromptProps, DefaultPrePrompt, type DefaultPrePromptProps, type MultiPermissionEntry, type MultiplePermissionsConfig, type MultiplePermissionsResult, type PermissionCallbacks, type PermissionFlowEvent, type PermissionFlowState, PermissionGate, type PermissionGateProps, type PermissionHandlerConfig, type PermissionHandlerResult, type PrePromptConfig, transition, useMultiplePermissions, usePermissionHandler };
+export { BlockedPromptConfig, DefaultBlockedPrompt, type DefaultBlockedPromptProps, DefaultPrePrompt, type DefaultPrePromptProps, MultiplePermissionsConfig, MultiplePermissionsResult, PermissionCallbacks, PermissionEngine, PermissionFlowEvent, PermissionFlowState, PermissionGate, type PermissionGateProps, PermissionHandlerConfig, PermissionHandlerResult, PrePromptConfig, setDefaultEngine, transition, useMultiplePermissions, usePermissionHandler };

package/dist/index.d.ts

@@ -1,110 +1,9 @@
-import { Permission, PermissionStatus } from 'react-native-permissions';
+import { P as PermissionEngine, a as PermissionFlowState, b as PermissionFlowEvent, c as PermissionHandlerConfig, d as PermissionHandlerResult, M as MultiplePermissionsConfig, e as MultiplePermissionsResult, f as PermissionCallbacks, g as PrePromptConfig, B as BlockedPromptConfig } from './types-QXyq8VnD.js';
+export { h as MultiPermissionEntry, i as PermissionStatus } from './types-QXyq8VnD.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 
-/**
- * States of the permission flow state machine.
- */
-type PermissionFlowState = "idle" | "checking" | "prePrompt" | "requesting" | "granted" | "denied" | "blocked" | "blockedPrompt" | "openingSettings" | "recheckingAfterSettings" | "unavailable";
-/**
- * Events that drive state transitions.
- */
-type PermissionFlowEvent = {
-    type: "CHECK";
-} | {
-    type: "CHECK_RESULT";
-    status: PermissionStatus;
-} | {
-    type: "PRE_PROMPT_CONFIRM";
-} | {
-    type: "PRE_PROMPT_DISMISS";
-} | {
-    type: "REQUEST_RESULT";
-    status: PermissionStatus;
-} | {
-    type: "OPEN_SETTINGS";
-} | {
-    type: "SETTINGS_RETURN";
-} | {
-    type: "RECHECK_RESULT";
-    status: PermissionStatus;
-};
-/**
- * Configuration for the pre-prompt modal.
- */
-interface PrePromptConfig {
-    title: string;
-    message: string;
-    confirmLabel?: string;
-    cancelLabel?: string;
-}
-/**
- * Configuration for the blocked-prompt modal.
- */
-interface BlockedPromptConfig {
-    title: string;
-    message: string;
-    settingsLabel?: string;
-}
-/**
- * Callbacks for analytics and side effects.
- */
-interface PermissionCallbacks {
-    onGrant?: () => void;
-    onDeny?: () => void;
-    onBlock?: () => void;
-    onSettingsReturn?: (granted: boolean) => void;
-}
-/**
- * Configuration for usePermissionHandler.
- */
-interface PermissionHandlerConfig extends PermissionCallbacks {
-    permission: Permission | "notifications";
-    prePrompt: PrePromptConfig;
-    blockedPrompt: BlockedPromptConfig;
-    autoCheck?: boolean;
-    recheckOnForeground?: boolean;
-}
-/**
- * Return type of usePermissionHandler.
- */
-interface PermissionHandlerResult {
-    state: PermissionFlowState;
-    nativeStatus: PermissionStatus | null;
-    isGranted: boolean;
-    isDenied: boolean;
-    isBlocked: boolean;
-    isChecking: boolean;
-    isUnavailable: boolean;
-    request: () => void;
-    check: () => void;
-    dismiss: () => void;
-    openSettings: () => void;
-}
-/**
- * Configuration for a single permission within useMultiplePermissions.
- */
-interface MultiPermissionEntry extends PermissionCallbacks {
-    permission: Permission | "notifications";
-    prePrompt: PrePromptConfig;
-    blockedPrompt: BlockedPromptConfig;
-}
-/**
- * Configuration for useMultiplePermissions.
- */
-interface MultiplePermissionsConfig {
-    permissions: MultiPermissionEntry[];
-    strategy: "sequential" | "parallel";
-    onAllGranted?: () => void;
-}
-/**
- * Return type of useMultiplePermissions.
- */
-interface MultiplePermissionsResult {
-    statuses: Record<string, PermissionFlowState>;
-    allGranted: boolean;
-    request: () => void;
-}
+declare function setDefaultEngine(engine: PermissionEngine): void;
 
 declare function transition(state: PermissionFlowState, event: PermissionFlowEvent): PermissionFlowState;
 
@@ -113,7 +12,8 @@ declare function usePermissionHandler(config: PermissionHandlerConfig): Permissi
 declare function useMultiplePermissions(config: MultiplePermissionsConfig): MultiplePermissionsResult;
 
 interface PermissionGateProps extends PermissionCallbacks {
-    permission: Permission | "notifications";
+    permission: string;
+    engine?: PermissionEngine;
     prePrompt: PrePromptConfig;
     blockedPrompt: BlockedPromptConfig;
     children: ReactNode;
@@ -128,7 +28,7 @@ interface PermissionGateProps extends PermissionCallbacks {
         onOpenSettings: () => void;
     }) => ReactNode;
 }
-declare function PermissionGate({ permission, prePrompt, blockedPrompt, children, fallback, renderPrePrompt, renderBlockedPrompt, onGrant, onDeny, onBlock, onSettingsReturn, }: PermissionGateProps): react_jsx_runtime.JSX.Element;
+declare function PermissionGate({ permission, engine, prePrompt, blockedPrompt, children, fallback, renderPrePrompt, renderBlockedPrompt, onGrant, onDeny, onBlock, onSettingsReturn, }: PermissionGateProps): react_jsx_runtime.JSX.Element;
 
 interface DefaultPrePromptProps extends PrePromptConfig {
     visible: boolean;
@@ -143,4 +43,4 @@ interface DefaultBlockedPromptProps extends BlockedPromptConfig {
 }
 declare function DefaultBlockedPrompt({ visible, title, message, settingsLabel, onOpenSettings, }: DefaultBlockedPromptProps): react_jsx_runtime.JSX.Element;
 
-export { type BlockedPromptConfig, DefaultBlockedPrompt, type DefaultBlockedPromptProps, DefaultPrePrompt, type DefaultPrePromptProps, type MultiPermissionEntry, type MultiplePermissionsConfig, type MultiplePermissionsResult, type PermissionCallbacks, type PermissionFlowEvent, type PermissionFlowState, PermissionGate, type PermissionGateProps, type PermissionHandlerConfig, type PermissionHandlerResult, type PrePromptConfig, transition, useMultiplePermissions, usePermissionHandler };
+export { BlockedPromptConfig, DefaultBlockedPrompt, type DefaultBlockedPromptProps, DefaultPrePrompt, type DefaultPrePromptProps, MultiplePermissionsConfig, MultiplePermissionsResult, PermissionCallbacks, PermissionEngine, PermissionFlowEvent, PermissionFlowState, PermissionGate, type PermissionGateProps, PermissionHandlerConfig, PermissionHandlerResult, PrePromptConfig, setDefaultEngine, transition, useMultiplePermissions, usePermissionHandler };