react-native-permission-gate 0.1.0

package/lib/module/hooks/usePermission.js

@@ -0,0 +1,162 @@
+"use strict";
+
+import { useCallback, useContext, useEffect, useMemo, useRef, useState } from 'react';
+import { AppState } from 'react-native';
+import { reduce } from "../core/machine.js";
+import { PermissionContext } from "../context.js";
+/**
+ * Headless permission-flow controller. Owns the state machine and wires its
+ * effects to the native adapter; renders nothing. Bring your own rationale and
+ * "blocked" UI and drive it off `phase` / `status`.
+ */
+export function usePermission(name, options = {}) {
+  const ctx = useContext(PermissionContext);
+  const rationale = options.rationale ?? ctx.defaults.rationale ?? false;
+  const revalidateOnFocus = options.revalidateOnFocus ?? ctx.defaults.revalidateOnFocus ?? true;
+  const requestOnMount = options.requestOnMount ?? ctx.defaults.requestOnMount ?? false;
+  const onStatusChange = options.onStatusChange;
+  const adapter = options.adapter ?? ctx.adapter;
+  const supported = adapter.isSupported(name);
+  const neutral = () => ({
+    status: supported ? 'requestable' : 'unavailable',
+    phase: 'idle'
+  });
+  const [state, setState] = useState(neutral);
+
+  // Mirror volatile values in refs so async effect callbacks read fresh data
+  // and the public callbacks stay referentially stable.
+  const stateRef = useRef(state);
+  stateRef.current = state;
+  const rationaleRef = useRef(rationale);
+  rationaleRef.current = rationale;
+  const onStatusChangeRef = useRef(onStatusChange);
+  onStatusChangeRef.current = onStatusChange;
+  const requestOnMountRef = useRef(requestOnMount);
+  requestOnMountRef.current = requestOnMount;
+
+  // Single in-flight request. Dedupes concurrent/double `request()` calls so a
+  // double-tap can never orphan a promise or fire two native prompts.
+  const pendingRef = useRef(null);
+  const mountedRef = useRef(true);
+  const dispatch = useCallback(event => {
+    const {
+      state: next,
+      effects
+    } = reduce(stateRef.current, event, {
+      rationale: rationaleRef.current
+    });
+    stateRef.current = next;
+    if (mountedRef.current) setState(next);
+    for (const effect of effects) {
+      if (effect.type === 'resolve') {
+        const pending = pendingRef.current;
+        pendingRef.current = null;
+        pending?.resolve(effect.status);
+      } else if (effect.type === 'runRequest') {
+        adapter.request(name).then(status => dispatchRef.current({
+          type: 'REQUEST_RESULT',
+          status
+        })).catch(() => dispatchRef.current({
+          type: 'REQUEST_RESULT',
+          status: stateRef.current.status
+        }));
+      }
+    }
+  }, [adapter, name]);
+  const dispatchRef = useRef(dispatch);
+  dispatchRef.current = dispatch;
+  const request = useCallback(() => {
+    // Reuse the in-flight promise instead of starting a second flow.
+    if (pendingRef.current) return pendingRef.current.promise;
+    let resolve;
+    const promise = new Promise(r => {
+      resolve = r;
+    });
+    pendingRef.current = {
+      promise,
+      resolve
+    };
+    dispatchRef.current({
+      type: 'REQUEST'
+    });
+    return promise;
+  }, []);
+  const requestRef = useRef(request);
+  requestRef.current = request;
+  const confirmRationale = useCallback(() => dispatchRef.current({
+    type: 'CONFIRM_RATIONALE'
+  }), []);
+  const cancelRationale = useCallback(() => dispatchRef.current({
+    type: 'CANCEL_RATIONALE'
+  }), []);
+  const refresh = useCallback(async () => {
+    if (!supported) return 'unavailable';
+    const status = await adapter.check(name);
+    dispatchRef.current({
+      type: 'REFRESH_RESULT',
+      status
+    });
+    return status;
+  }, [adapter, name, supported]);
+  const refreshRef = useRef(refresh);
+  refreshRef.current = refresh;
+  const openSettings = useCallback(() => adapter.openSettings(), [adapter]);
+
+  // Initial check on mount and whenever the permission identity changes. On a
+  // change we reset to a neutral state first so a stale status never lingers.
+  const firstRunRef = useRef(true);
+  useEffect(() => {
+    mountedRef.current = true;
+    if (!firstRunRef.current) {
+      const reset = neutral();
+      stateRef.current = reset;
+      setState(reset);
+      pendingRef.current = null;
+    }
+    firstRunRef.current = false;
+    if (supported) {
+      adapter.check(name).then(status => {
+        dispatchRef.current({
+          type: 'CHECK_RESULT',
+          status
+        });
+        if (requestOnMountRef.current) requestRef.current();
+      }).catch(() => {});
+    }
+    return () => {
+      mountedRef.current = false;
+    };
+    // `neutral` is derived from supported; requestOnMount is read via ref.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [adapter, name, supported]);
+
+  // Re-check when the app returns to the foreground.
+  useEffect(() => {
+    if (!revalidateOnFocus || !supported) return;
+    const sub = AppState.addEventListener('change', next => {
+      if (next === 'active') refreshRef.current();
+    });
+    return () => sub.remove();
+  }, [revalidateOnFocus, supported]);
+
+  // Notify on resolved-status changes.
+  const prevStatusRef = useRef(state.status);
+  useEffect(() => {
+    if (prevStatusRef.current !== state.status) {
+      prevStatusRef.current = state.status;
+      onStatusChangeRef.current?.(state.status);
+    }
+  }, [state.status]);
+  return useMemo(() => ({
+    status: state.status,
+    phase: state.phase,
+    isGranted: state.status === 'granted',
+    isBlocked: state.status === 'blocked',
+    request,
+    confirmRationale,
+    cancelRationale,
+    openSettings,
+    refresh
+  }), [state.status, state.phase, request, confirmRationale, cancelRationale, openSettings, refresh]);
+}
+//# sourceMappingURL=usePermission.js.map

package/lib/module/hooks/usePermission.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useContext","useEffect","useMemo","useRef","useState","AppState","reduce","PermissionContext","usePermission","name","options","ctx","rationale","defaults","revalidateOnFocus","requestOnMount","onStatusChange","adapter","supported","isSupported","neutral","status","phase","state","setState","stateRef","current","rationaleRef","onStatusChangeRef","requestOnMountRef","pendingRef","mountedRef","dispatch","event","next","effects","effect","type","pending","resolve","request","then","dispatchRef","catch","promise","Promise","r","requestRef","confirmRationale","cancelRationale","refresh","check","refreshRef","openSettings","firstRunRef","reset","sub","addEventListener","remove","prevStatusRef","isGranted","isBlocked"],"sourceRoot":"../../../src","sources":["hooks/usePermission.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/hooks/usePermissions.js

@@ -0,0 +1,165 @@
+"use strict";
+
+import { useCallback, useContext, useEffect, useMemo, useRef, useState } from 'react';
+import { AppState } from 'react-native';
+import { PermissionContext } from "../context.js";
+/**
+ * Aggregate variant of {@link usePermission} for permissions acquired together
+ * (e.g. camera + microphone for video). One shared rationale gate, one
+ * `request()`, one status map. The `names` array is treated as a stable set -
+ * pass a constant or memoized array.
+ */
+export function usePermissions(names, options = {}) {
+  const ctx = useContext(PermissionContext);
+  const rationale = options.rationale ?? ctx.defaults.rationale ?? false;
+  const revalidateOnFocus = options.revalidateOnFocus ?? ctx.defaults.revalidateOnFocus ?? true;
+  const requestOnMount = options.requestOnMount ?? ctx.defaults.requestOnMount ?? false;
+  const adapter = options.adapter ?? ctx.adapter;
+
+  // Stable identity for the set so effects don't re-run on every new array.
+  const key = names.join(',');
+  const buildInitial = useCallback(() => {
+    const map = {};
+    for (const name of names) {
+      map[name] = adapter.isSupported(name) ? 'requestable' : 'unavailable';
+    }
+    return map;
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [adapter, key]);
+  const [statuses, setStatuses] = useState(buildInitial);
+  const [phase, setPhase] = useState('idle');
+  const statusesRef = useRef(statuses);
+  statusesRef.current = statuses;
+  const phaseRef = useRef(phase);
+  phaseRef.current = phase;
+  const rationaleRef = useRef(rationale);
+  rationaleRef.current = rationale;
+  const requestOnMountRef = useRef(requestOnMount);
+  requestOnMountRef.current = requestOnMount;
+  const pendingRef = useRef(null);
+  const requestableRef = useRef([]);
+  const mountedRef = useRef(true);
+  const commit = useCallback(next => {
+    statusesRef.current = next;
+    if (mountedRef.current) setStatuses(next);
+  }, []);
+  const settle = useCallback(() => {
+    if (mountedRef.current) setPhase('settled');
+    const pending = pendingRef.current;
+    pendingRef.current = null;
+    pending?.resolve(statusesRef.current);
+  }, []);
+  const runBatch = useCallback(async list => {
+    if (mountedRef.current) setPhase('requesting');
+    for (const name of list) {
+      try {
+        const status = await adapter.request(name);
+        commit({
+          ...statusesRef.current,
+          [name]: status
+        });
+      } catch {
+        // Keep the previous status for this permission on failure.
+      }
+    }
+    settle();
+  }, [adapter, commit, settle]);
+  const runBatchRef = useRef(runBatch);
+  runBatchRef.current = runBatch;
+  const request = useCallback(() => {
+    if (pendingRef.current) return pendingRef.current.promise;
+    let resolve;
+    const promise = new Promise(r => {
+      resolve = r;
+    });
+    pendingRef.current = {
+      promise,
+      resolve
+    };
+    const requestable = names.filter(name => statusesRef.current[name] === 'requestable');
+    requestableRef.current = requestable;
+    if (requestable.length === 0) {
+      settle();
+    } else if (rationaleRef.current) {
+      if (mountedRef.current) setPhase('rationale');
+    } else {
+      runBatchRef.current(requestable);
+    }
+    return promise;
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [key, settle]);
+  const requestRef = useRef(request);
+  requestRef.current = request;
+  const confirmRationale = useCallback(() => {
+    if (phaseRef.current !== 'rationale') return;
+    runBatchRef.current(requestableRef.current);
+  }, []);
+  const cancelRationale = useCallback(() => {
+    if (phaseRef.current !== 'rationale') return;
+    if (mountedRef.current) setPhase('idle');
+    const pending = pendingRef.current;
+    pendingRef.current = null;
+    pending?.resolve(statusesRef.current);
+  }, []);
+  const refresh = useCallback(async () => {
+    const entries = await Promise.all(names.map(async name => {
+      if (!adapter.isSupported(name)) {
+        return [name, 'unavailable'];
+      }
+      return [name, await adapter.check(name)];
+    }));
+    const next = {};
+    for (const [name, status] of entries) next[name] = status;
+    commit(next);
+    return next;
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [adapter, key, commit]);
+  const refreshRef = useRef(refresh);
+  refreshRef.current = refresh;
+  const openSettings = useCallback(() => adapter.openSettings(), [adapter]);
+
+  // Initial check on mount / when the set changes.
+  const firstRunRef = useRef(true);
+  useEffect(() => {
+    mountedRef.current = true;
+    if (!firstRunRef.current) {
+      commit(buildInitial());
+      setPhase('idle');
+      pendingRef.current = null;
+    }
+    firstRunRef.current = false;
+    refreshRef.current().then(() => {
+      if (requestOnMountRef.current) requestRef.current();
+    });
+    return () => {
+      mountedRef.current = false;
+    };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [key]);
+
+  // Re-check on foreground.
+  useEffect(() => {
+    if (!revalidateOnFocus) return;
+    const sub = AppState.addEventListener('change', next => {
+      if (next === 'active') refreshRef.current();
+    });
+    return () => sub.remove();
+  }, [revalidateOnFocus]);
+  return useMemo(() => {
+    const allGranted = names.every(name => statuses[name] === 'granted');
+    const anyBlocked = names.some(name => statuses[name] === 'blocked');
+    return {
+      statuses,
+      phase,
+      allGranted,
+      anyBlocked,
+      request,
+      confirmRationale,
+      cancelRationale,
+      openSettings,
+      refresh
+    };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [key, statuses, phase, request, confirmRationale, cancelRationale, openSettings, refresh]);
+}
+//# sourceMappingURL=usePermissions.js.map

package/lib/module/hooks/usePermissions.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useContext","useEffect","useMemo","useRef","useState","AppState","PermissionContext","usePermissions","names","options","ctx","rationale","defaults","revalidateOnFocus","requestOnMount","adapter","key","join","buildInitial","map","name","isSupported","statuses","setStatuses","phase","setPhase","statusesRef","current","phaseRef","rationaleRef","requestOnMountRef","pendingRef","requestableRef","mountedRef","commit","next","settle","pending","resolve","runBatch","list","status","request","runBatchRef","promise","Promise","r","requestable","filter","length","requestRef","confirmRationale","cancelRationale","refresh","entries","all","check","refreshRef","openSettings","firstRunRef","then","sub","addEventListener","remove","allGranted","every","anyBlocked","some"],"sourceRoot":"../../../src","sources":["hooks/usePermissions.ts"],"mappings":";;AAAA,SACEA,WAAW,EACXC,UAAU,EACVC,SAAS,EACTC,OAAO,EACPC,MAAM,EACNC,QAAQ,QACH,OAAO;AACd,SAASC,QAAQ,QAA6B,cAAc;AAC5D,SAASC,iBAAiB,QAAQ,eAAY;AAwC9C;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAC5BC,KAAuB,EACvBC,OAA6B,GAAG,CAAC,CAAC,EACX;EACvB,MAAMC,GAAG,GAAGV,UAAU,CAACM,iBAAiB,CAAC;EACzC,MAAMK,SAAS,GAAGF,OAAO,CAACE,SAAS,IAAID,GAAG,CAACE,QAAQ,CAACD,SAAS,IAAI,KAAK;EACtE,MAAME,iBAAiB,GACrBJ,OAAO,CAACI,iBAAiB,IAAIH,GAAG,CAACE,QAAQ,CAACC,iBAAiB,IAAI,IAAI;EACrE,MAAMC,cAAc,GAClBL,OAAO,CAACK,cAAc,IAAIJ,GAAG,CAACE,QAAQ,CAACE,cAAc,IAAI,KAAK;EAChE,MAAMC,OAAO,GAAGN,OAAO,CAACM,OAAO,IAAIL,GAAG,CAACK,OAAO;;EAE9C;EACA,MAAMC,GAAG,GAAGR,KAAK,CAACS,IAAI,CAAC,GAAG,CAAC;EAE3B,MAAMC,YAAY,GAAGnB,WAAW,CAAC,MAA2B;IAC1D,MAAMoB,GAAwB,GAAG,CAAC,CAAC;IACnC,KAAK,MAAMC,IAAI,IAAIZ,KAAK,EAAE;MACxBW,GAAG,CAACC,IAAI,CAAC,GAAGL,OAAO,CAACM,WAAW,CAACD,IAAI,CAAC,GAAG,aAAa,GAAG,aAAa;IACvE;IACA,OAAOD,GAAG;IACV;EACF,CAAC,EAAE,CAACJ,OAAO,EAAEC,GAAG,CAAC,CAAC;EAElB,MAAM,CAACM,QAAQ,EAAEC,WAAW,CAAC,GAAGnB,QAAQ,CAAsBc,YAAY,CAAC;EAC3E,MAAM,CAACM,KAAK,EAAEC,QAAQ,CAAC,GAAGrB,QAAQ,CAAY,MAAM,CAAC;EAErD,MAAMsB,WAAW,GAAGvB,MAAM,CAACmB,QAAQ,CAAC;EACpCI,WAAW,CAACC,OAAO,GAAGL,QAAQ;EAC9B,MAAMM,QAAQ,GAAGzB,MAAM,CAACqB,KAAK,CAAC;EAC9BI,QAAQ,CAACD,OAAO,GAAGH,KAAK;EACxB,MAAMK,YAAY,GAAG1B,MAAM,CAACQ,SAAS,CAAC;EACtCkB,YAAY,CAACF,OAAO,GAAGhB,SAAS;EAChC,MAAMmB,iBAAiB,GAAG3B,MAAM,CAACW,cAAc,CAAC;EAChDgB,iBAAiB,CAACH,OAAO,GAAGb,cAAc;EAE1C,MAAMiB,UAAU,GAAG5B,MAAM,CAAiB,IAAI,CAAC;EAC/C,MAAM6B,cAAc,GAAG7B,MAAM,CAAmB,EAAE,CAAC;EACnD,MAAM8B,UAAU,GAAG9B,MAAM,CAAC,IAAI,CAAC;EAE/B,MAAM+B,MAAM,GAAGnC,WAAW,CAAEoC,IAAyB,IAAK;IACxDT,WAAW,CAACC,OAAO,GAAGQ,IAAI;IAC1B,IAAIF,UAAU,CAACN,OAAO,EAAEJ,WAAW,CAACY,IAAI,CAAC;EAC3C,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMC,MAAM,GAAGrC,WAAW,CAAC,MAAM;IAC/B,IAAIkC,UAAU,CAACN,OAAO,EAAEF,QAAQ,CAAC,SAAS,CAAC;IAC3C,MAAMY,OAAO,GAAGN,UAAU,CAACJ,OAAO;IAClCI,UAAU,CAACJ,OAAO,GAAG,IAAI;IACzBU,OAAO,EAAEC,OAAO,CAACZ,WAAW,CAACC,OAAO,CAAC;EACvC,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMY,QAAQ,GAAGxC,WAAW,CAC1B,MAAOyC,IAAsB,IAAK;IAChC,IAAIP,UAAU,CAACN,OAAO,EAAEF,QAAQ,CAAC,YAAY,CAAC;IAC9C,KAAK,MAAML,IAAI,IAAIoB,IAAI,EAAE;MACvB,IAAI;QACF,MAAMC,MAAM,GAAG,MAAM1B,OAAO,CAAC2B,OAAO,CAACtB,IAAI,CAAC;QAC1Cc,MAAM,CAAC;UAAE,GAAGR,WAAW,CAACC,OAAO;UAAE,CAACP,IAAI,GAAGqB;QAAO,CAAC,CAAC;MACpD,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ;IACAL,MAAM,CAAC,CAAC;EACV,CAAC,EACD,CAACrB,OAAO,EAAEmB,MAAM,EAAEE,MAAM,CAC1B,CAAC;EACD,MAAMO,WAAW,GAAGxC,MAAM,CAACoC,QAAQ,CAAC;EACpCI,WAAW,CAAChB,OAAO,GAAGY,QAAQ;EAE9B,MAAMG,OAAO,GAAG3C,WAAW,CAAC,MAAM;IAChC,IAAIgC,UAAU,CAACJ,OAAO,EAAE,OAAOI,UAAU,CAACJ,OAAO,CAACiB,OAAO;IAEzD,IAAIN,OAA4C;IAChD,MAAMM,OAAO,GAAG,IAAIC,OAAO,CAAuBC,CAAC,IAAK;MACtDR,OAAO,GAAGQ,CAAC;IACb,CAAC,CAAC;IACFf,UAAU,CAACJ,OAAO,GAAG;MAAEiB,OAAO;MAAEN;IAAQ,CAAC;IAEzC,MAAMS,WAAW,GAAGvC,KAAK,CAACwC,MAAM,CAC7B5B,IAAI,IAAKM,WAAW,CAACC,OAAO,CAACP,IAAI,CAAC,KAAK,aAC1C,CAAC;IACDY,cAAc,CAACL,OAAO,GAAGoB,WAAW;IAEpC,IAAIA,WAAW,CAACE,MAAM,KAAK,CAAC,EAAE;MAC5Bb,MAAM,CAAC,CAAC;IACV,CAAC,MAAM,IAAIP,YAAY,CAACF,OAAO,EAAE;MAC/B,IAAIM,UAAU,CAACN,OAAO,EAAEF,QAAQ,CAAC,WAAW,CAAC;IAC/C,CAAC,MAAM;MACLkB,WAAW,CAAChB,OAAO,CAACoB,WAAW,CAAC;IAClC;IACA,OAAOH,OAAO;IACd;EACF,CAAC,EAAE,CAAC5B,GAAG,EAAEoB,MAAM,CAAC,CAAC;EACjB,MAAMc,UAAU,GAAG/C,MAAM,CAACuC,OAAO,CAAC;EAClCQ,UAAU,CAACvB,OAAO,GAAGe,OAAO;EAE5B,MAAMS,gBAAgB,GAAGpD,WAAW,CAAC,MAAM;IACzC,IAAI6B,QAAQ,CAACD,OAAO,KAAK,WAAW,EAAE;IACtCgB,WAAW,CAAChB,OAAO,CAACK,cAAc,CAACL,OAAO,CAAC;EAC7C,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMyB,eAAe,GAAGrD,WAAW,CAAC,MAAM;IACxC,IAAI6B,QAAQ,CAACD,OAAO,KAAK,WAAW,EAAE;IACtC,IAAIM,UAAU,CAACN,OAAO,EAAEF,QAAQ,CAAC,MAAM,CAAC;IACxC,MAAMY,OAAO,GAAGN,UAAU,CAACJ,OAAO;IAClCI,UAAU,CAACJ,OAAO,GAAG,IAAI;IACzBU,OAAO,EAAEC,OAAO,CAACZ,WAAW,CAACC,OAAO,CAAC;EACvC,CAAC,EAAE,EAAE,CAAC;EAEN,MAAM0B,OAAO,GAAGtD,WAAW,CAAC,YAAY;IACtC,MAAMuD,OAAO,GAAG,MAAMT,OAAO,CAACU,GAAG,CAC/B/C,KAAK,CAACW,GAAG,CAAC,MAAOC,IAAI,IAAK;MACxB,IAAI,CAACL,OAAO,CAACM,WAAW,CAACD,IAAI,CAAC,EAAE;QAC9B,OAAO,CAACA,IAAI,EAAE,aAAa,CAAC;MAC9B;MACA,OAAO,CAACA,IAAI,EAAE,MAAML,OAAO,CAACyC,KAAK,CAACpC,IAAI,CAAC,CAAC;IAC1C,CAAC,CACH,CAAC;IACD,MAAMe,IAAyB,GAAG,CAAC,CAAC;IACpC,KAAK,MAAM,CAACf,IAAI,EAAEqB,MAAM,CAAC,IAAIa,OAAO,EAAEnB,IAAI,CAACf,IAAI,CAAC,GAAGqB,MAAM;IACzDP,MAAM,CAACC,IAAI,CAAC;IACZ,OAAOA,IAAI;IACX;EACF,CAAC,EAAE,CAACpB,OAAO,EAAEC,GAAG,EAAEkB,MAAM,CAAC,CAAC;EAC1B,MAAMuB,UAAU,GAAGtD,MAAM,CAACkD,OAAO,CAAC;EAClCI,UAAU,CAAC9B,OAAO,GAAG0B,OAAO;EAE5B,MAAMK,YAAY,GAAG3D,WAAW,CAAC,MAAMgB,OAAO,CAAC2C,YAAY,CAAC,CAAC,EAAE,CAAC3C,OAAO,CAAC,CAAC;;EAEzE;EACA,MAAM4C,WAAW,GAAGxD,MAAM,CAAC,IAAI,CAAC;EAChCF,SAAS,CAAC,MAAM;IACdgC,UAAU,CAACN,OAAO,GAAG,IAAI;IACzB,IAAI,CAACgC,WAAW,CAAChC,OAAO,EAAE;MACxBO,MAAM,CAAChB,YAAY,CAAC,CAAC,CAAC;MACtBO,QAAQ,CAAC,MAAM,CAAC;MAChBM,UAAU,CAACJ,OAAO,GAAG,IAAI;IAC3B;IACAgC,WAAW,CAAChC,OAAO,GAAG,KAAK;IAE3B8B,UAAU,CAAC9B,OAAO,CAAC,CAAC,CAACiC,IAAI,CAAC,MAAM;MAC9B,IAAI9B,iBAAiB,CAACH,OAAO,EAAEuB,UAAU,CAACvB,OAAO,CAAC,CAAC;IACrD,CAAC,CAAC;IAEF,OAAO,MAAM;MACXM,UAAU,CAACN,OAAO,GAAG,KAAK;IAC5B,CAAC;IACD;EACF,CAAC,EAAE,CAACX,GAAG,CAAC,CAAC;;EAET;EACAf,SAAS,CAAC,MAAM;IACd,IAAI,CAACY,iBAAiB,EAAE;IACxB,MAAMgD,GAAG,GAAGxD,QAAQ,CAACyD,gBAAgB,CAAC,QAAQ,EAAG3B,IAAoB,IAAK;MACxE,IAAIA,IAAI,KAAK,QAAQ,EAAEsB,UAAU,CAAC9B,OAAO,CAAC,CAAC;IAC7C,CAAC,CAAC;IACF,OAAO,MAAMkC,GAAG,CAACE,MAAM,CAAC,CAAC;EAC3B,CAAC,EAAE,CAAClD,iBAAiB,CAAC,CAAC;EAEvB,OAAOX,OAAO,CAAwB,MAAM;IAC1C,MAAM8D,UAAU,GAAGxD,KAAK,CAACyD,KAAK,CAAE7C,IAAI,IAAKE,QAAQ,CAACF,IAAI,CAAC,KAAK,SAAS,CAAC;IACtE,MAAM8C,UAAU,GAAG1D,KAAK,CAAC2D,IAAI,CAAE/C,IAAI,IAAKE,QAAQ,CAACF,IAAI,CAAC,KAAK,SAAS,CAAC;IACrE,OAAO;MACLE,QAAQ;MACRE,KAAK;MACLwC,UAAU;MACVE,UAAU;MACVxB,OAAO;MACPS,gBAAgB;MAChBC,eAAe;MACfM,YAAY;MACZL;IACF,CAAC;IACD;EACF,CAAC,EAAE,CACDrC,GAAG,EACHM,QAAQ,EACRE,KAAK,EACLkB,OAAO,EACPS,gBAAgB,EAChBC,eAAe,EACfM,YAAY,EACZL,OAAO,CACR,CAAC;AACJ","ignoreList":[]}

package/lib/module/imperative.js

@@ -0,0 +1,24 @@
+"use strict";
+
+import { reactNativePermissionsAdapter } from "./adapters/reactNativePermissions.js";
+/**
+ * Imperative helpers for use outside React (services, sagas, utilities). These
+ * are the raw check/request/openSettings calls with no rationale UX - for the
+ * full flow with pre-prompts, use {@link usePermission} or {@link PermissionGate}.
+ */
+
+/** Read current status without prompting. */
+export function checkPermission(name, adapter = reactNativePermissionsAdapter) {
+  return adapter.check(name);
+}
+
+/** Trigger the native OS prompt and resolve with the resulting status. */
+export function requestPermission(name, adapter = reactNativePermissionsAdapter) {
+  return adapter.request(name);
+}
+
+/** Open the OS settings screen for this app. */
+export function openAppSettings(adapter = reactNativePermissionsAdapter) {
+  return adapter.openSettings();
+}
+//# sourceMappingURL=imperative.js.map

package/lib/module/imperative.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["reactNativePermissionsAdapter","checkPermission","name","adapter","check","requestPermission","request","openAppSettings","openSettings"],"sourceRoot":"../../src","sources":["imperative.ts"],"mappings":";;AAAA,SAASA,6BAA6B,QAAQ,sCAAmC;AAOjF;AACA;AACA;AACA;AACA;;AAEA;AACA,OAAO,SAASC,eAAeA,CAC7BC,IAAoB,EACpBC,OAA0B,GAAGH,6BAA6B,EAC/B;EAC3B,OAAOG,OAAO,CAACC,KAAK,CAACF,IAAI,CAAC;AAC5B;;AAEA;AACA,OAAO,SAASG,iBAAiBA,CAC/BH,IAAoB,EACpBC,OAA0B,GAAGH,6BAA6B,EAC/B;EAC3B,OAAOG,OAAO,CAACG,OAAO,CAACJ,IAAI,CAAC;AAC9B;;AAEA;AACA,OAAO,SAASK,eAAeA,CAC7BJ,OAA0B,GAAGH,6BAA6B,EAC3C;EACf,OAAOG,OAAO,CAACK,YAAY,CAAC,CAAC;AAC/B","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,15 @@
+"use strict";
+
+// Hooks - the primary, headless API.
+export { usePermission } from "./hooks/usePermission.js";
+export { usePermissions } from "./hooks/usePermissions.js";
+// Declarative convenience.
+export { PermissionGate } from "./components/PermissionGate.js";
+// Provider - optional shared adapter + default options.
+export { PermissionProvider, PermissionContext } from "./context.js";
+// Imperative helpers for use outside React.
+export { checkPermission, requestPermission, openAppSettings } from "./imperative.js";
+
+// Default adapter (override via options.adapter or PermissionProvider).
+export { reactNativePermissionsAdapter } from "./adapters/reactNativePermissions.js";
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["usePermission","usePermissions","PermissionGate","PermissionProvider","PermissionContext","checkPermission","requestPermission","openAppSettings","reactNativePermissionsAdapter"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA;AACA,SAASA,aAAa,QAAQ,0BAAuB;AACrD,SAASC,cAAc,QAAQ,2BAAwB;AAMvD;AACA,SAASC,cAAc,QAAQ,gCAA6B;AAO5D;AACA,SAASC,kBAAkB,EAAEC,iBAAiB,QAAQ,cAAW;AAOjE;AACA,SACEC,eAAe,EACfC,iBAAiB,EACjBC,eAAe,QACV,iBAAc;;AAErB;AACA,SAASC,6BAA6B,QAAQ,sCAAmC","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/module/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

package/lib/module/types.js.map

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

package/lib/typescript/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/src/adapters/reactNativePermissions.d.ts

@@ -0,0 +1,8 @@
+import type { PermissionAdapter } from '../types.js';
+/**
+ * Default adapter, backed by `react-native-permissions`. Notifications are a
+ * special case in the native library (a dedicated check/request API) and are
+ * routed accordingly.
+ */
+export declare const reactNativePermissionsAdapter: PermissionAdapter;
+//# sourceMappingURL=reactNativePermissions.d.ts.map

package/lib/typescript/src/adapters/reactNativePermissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactNativePermissions.d.ts","sourceRoot":"","sources":["../../../../src/adapters/reactNativePermissions.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,aAAU,CAAC;AA8DlB;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,EAAE,iBAmC3C,CAAC"}

package/lib/typescript/src/components/PermissionGate.d.ts

@@ -0,0 +1,34 @@
+import { type ReactNode } from 'react';
+import type { PermissionController, PermissionName, PermissionStatus, UsePermissionOptions } from '../types.js';
+export interface RationaleControls {
+    confirm: () => void;
+    cancel: () => void;
+    status: PermissionStatus;
+}
+export interface BlockedControls {
+    openSettings: () => Promise<void>;
+    status: PermissionStatus;
+}
+export interface PermissionGateProps {
+    name: PermissionName;
+    /** Forwarded to the underlying `usePermission`. `requestOnMount` defaults to true here. */
+    options?: UsePermissionOptions;
+    /**
+     * Rendered once access is granted (or limited). Pass a function to take full
+     * control and render for every state yourself.
+     */
+    children: ReactNode | ((controller: PermissionController) => ReactNode);
+    /** Your pre-prompt UI, shown while `phase === 'rationale'`. */
+    rationale?: (controls: RationaleControls) => ReactNode;
+    /** Your "go to Settings" UI, shown while the permission is blocked. */
+    blocked?: (controls: BlockedControls) => ReactNode;
+    /** Shown while not yet granted and no rationale/blocked UI applies. */
+    fallback?: ReactNode;
+}
+/**
+ * Declarative convenience over {@link usePermission}. Gates its children behind
+ * a granted permission and lets you plug in your own rationale / blocked UI.
+ * Auto-runs the request flow on mount unless you override `requestOnMount`.
+ */
+export declare function PermissionGate({ name, options, children, rationale, blocked, fallback, }: PermissionGateProps): import("react").JSX.Element;
+//# sourceMappingURL=PermissionGate.d.ts.map

package/lib/typescript/src/components/PermissionGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PermissionGate.d.ts","sourceRoot":"","sources":["../../../../src/components/PermissionGate.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,aAAU,CAAC;AAElB,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,cAAc,CAAC;IACrB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B;;;OAGG;IACH,QAAQ,EAAE,SAAS,GAAG,CAAC,CAAC,UAAU,EAAE,oBAAoB,KAAK,SAAS,CAAC,CAAC;IACxE,+DAA+D;IAC/D,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,SAAS,CAAC;IACvD,uEAAuE;IACvE,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,SAAS,CAAC;IACnD,uEAAuE;IACvE,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,SAAS,EACT,OAAO,EACP,QAAe,GAChB,EAAE,mBAAmB,+BA+BrB"}

package/lib/typescript/src/context.d.ts

@@ -0,0 +1,22 @@
+import { type ReactNode } from 'react';
+import type { PermissionAdapter, UsePermissionOptions } from './types.js';
+/** Options that can be defaulted for every hook/component under a provider. */
+export type PermissionDefaults = Pick<UsePermissionOptions, 'rationale' | 'revalidateOnFocus' | 'requestOnMount'>;
+export interface PermissionContextValue {
+    adapter: PermissionAdapter;
+    defaults: PermissionDefaults;
+}
+export declare const PermissionContext: import("react").Context<PermissionContextValue>;
+export interface PermissionProviderProps {
+    /** Override the backend for the whole tree. */
+    adapter?: PermissionAdapter;
+    /** Default options applied to every `usePermission` / `PermissionGate`. */
+    defaults?: PermissionDefaults;
+    children: ReactNode;
+}
+/**
+ * Optional. Sets a shared adapter and default options for the subtree so you
+ * don't repeat them at every call site. `usePermission` works without it.
+ */
+export declare function PermissionProvider({ adapter, defaults, children, }: PermissionProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=context.d.ts.map

package/lib/typescript/src/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/context.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAS,CAAC;AAEvE,+EAA+E;AAC/E,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,oBAAoB,EACpB,WAAW,GAAG,mBAAmB,GAAG,gBAAgB,CACrD,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED,eAAO,MAAM,iBAAiB,iDAG5B,CAAC;AAEH,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAuC,EACvC,QAAa,EACb,QAAQ,GACT,EAAE,uBAAuB,+BAMzB"}

package/lib/typescript/src/core/machine.d.ts

@@ -0,0 +1,47 @@
+import type { FlowPhase, PermissionStatus } from '../types.js';
+/**
+ * Pure, framework-free state machine that drives the permission UX flow.
+ *
+ * It has zero React and zero native dependencies: given the current state and an
+ * event, it returns the next state plus a list of side effects for the caller to
+ * interpret. This is what makes the whole flow unit-testable without a device.
+ */
+export interface MachineState {
+    status: PermissionStatus;
+    phase: FlowPhase;
+}
+export type MachineEvent = {
+    type: 'REQUEST';
+} | {
+    type: 'CONFIRM_RATIONALE';
+} | {
+    type: 'CANCEL_RATIONALE';
+} | {
+    type: 'REQUEST_RESULT';
+    status: PermissionStatus;
+} | {
+    type: 'CHECK_RESULT';
+    status: PermissionStatus;
+} | {
+    type: 'REFRESH_RESULT';
+    status: PermissionStatus;
+};
+export type MachineEffect = 
+/** Fire the adapter's native `request()`. */
+{
+    type: 'runRequest';
+}
+/** Resolve the pending `request()` promise with a final status. */
+ | {
+    type: 'resolve';
+    status: PermissionStatus;
+};
+export interface MachineContext {
+    rationale: boolean;
+}
+export interface Transition {
+    state: MachineState;
+    effects: MachineEffect[];
+}
+export declare function reduce(state: MachineState, event: MachineEvent, ctx: MachineContext): Transition;
+//# sourceMappingURL=machine.d.ts.map

package/lib/typescript/src/core/machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../../../../src/core/machine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAU,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,aAAa;AACvB,6CAA6C;AAC3C;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE;AACxB,mEAAmE;GACjE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAID,wBAAgB,MAAM,CACpB,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,cAAc,GAClB,UAAU,CAsDZ"}

package/lib/typescript/src/hooks/usePermission.d.ts

@@ -0,0 +1,8 @@
+import type { PermissionController, PermissionName, UsePermissionOptions } from '../types.js';
+/**
+ * Headless permission-flow controller. Owns the state machine and wires its
+ * effects to the native adapter; renders nothing. Bring your own rationale and
+ * "blocked" UI and drive it off `phase` / `status`.
+ */
+export declare function usePermission(name: PermissionName, options?: UsePermissionOptions): PermissionController;
+//# sourceMappingURL=usePermission.d.ts.map

package/lib/typescript/src/hooks/usePermission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePermission.d.ts","sourceRoot":"","sources":["../../../../src/hooks/usePermission.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EAEd,oBAAoB,EACrB,MAAM,aAAU,CAAC;AAOlB;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE,oBAAyB,GACjC,oBAAoB,CA6KtB"}

package/lib/typescript/src/hooks/usePermissions.d.ts

@@ -0,0 +1,32 @@
+import type { FlowPhase, PermissionName, PermissionStatus, UsePermissionOptions } from '../types.js';
+export type PermissionStatusMap = Partial<Record<PermissionName, PermissionStatus>>;
+export interface PermissionsController {
+    /** Current status per requested permission. */
+    statuses: PermissionStatusMap;
+    /** Shared flow position for the batch. */
+    phase: FlowPhase;
+    /** Every requested permission is `granted`. */
+    allGranted: boolean;
+    /** At least one requested permission is `blocked`. */
+    anyBlocked: boolean;
+    /**
+     * Run the flow for every not-yet-granted permission behind a single shared
+     * rationale gate. Prompts are shown one after another. Resolves with the
+     * final status map.
+     */
+    request: () => Promise<PermissionStatusMap>;
+    /** Proceed from the shared `rationale` phase to the prompts. */
+    confirmRationale: () => void;
+    /** Abort the shared `rationale` phase. */
+    cancelRationale: () => void;
+    openSettings: () => Promise<void>;
+    refresh: () => Promise<PermissionStatusMap>;
+}
+/**
+ * Aggregate variant of {@link usePermission} for permissions acquired together
+ * (e.g. camera + microphone for video). One shared rationale gate, one
+ * `request()`, one status map. The `names` array is treated as a stable set -
+ * pass a constant or memoized array.
+ */
+export declare function usePermissions(names: PermissionName[], options?: UsePermissionOptions): PermissionsController;
+//# sourceMappingURL=usePermissions.d.ts.map

package/lib/typescript/src/hooks/usePermissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePermissions.d.ts","sourceRoot":"","sources":["../../../../src/hooks/usePermissions.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,aAAU,CAAC;AAElB,MAAM,MAAM,mBAAmB,GAAG,OAAO,CACvC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CACzC,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,0CAA0C;IAC1C,KAAK,EAAE,SAAS,CAAC;IACjB,+CAA+C;IAC/C,UAAU,EAAE,OAAO,CAAC;IACpB,sDAAsD;IACtD,UAAU,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5C,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,0CAA0C;IAC1C,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC7C;AAOD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,GAAE,oBAAyB,GACjC,qBAAqB,CAsLvB"}

package/lib/typescript/src/imperative.d.ts

@@ -0,0 +1,13 @@
+import type { PermissionAdapter, PermissionName, PermissionStatus } from './types.js';
+/**
+ * Imperative helpers for use outside React (services, sagas, utilities). These
+ * are the raw check/request/openSettings calls with no rationale UX - for the
+ * full flow with pre-prompts, use {@link usePermission} or {@link PermissionGate}.
+ */
+/** Read current status without prompting. */
+export declare function checkPermission(name: PermissionName, adapter?: PermissionAdapter): Promise<PermissionStatus>;
+/** Trigger the native OS prompt and resolve with the resulting status. */
+export declare function requestPermission(name: PermissionName, adapter?: PermissionAdapter): Promise<PermissionStatus>;
+/** Open the OS settings screen for this app. */
+export declare function openAppSettings(adapter?: PermissionAdapter): Promise<void>;
+//# sourceMappingURL=imperative.d.ts.map

package/lib/typescript/src/imperative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imperative.d.ts","sourceRoot":"","sources":["../../../src/imperative.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAS,CAAC;AAEjB;;;;GAIG;AAEH,6CAA6C;AAC7C,wBAAgB,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE,iBAAiD,GACzD,OAAO,CAAC,gBAAgB,CAAC,CAE3B;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE,iBAAiD,GACzD,OAAO,CAAC,gBAAgB,CAAC,CAE3B;AAED,gDAAgD;AAChD,wBAAgB,eAAe,CAC7B,OAAO,GAAE,iBAAiD,GACzD,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/lib/typescript/src/index.d.ts

@@ -0,0 +1,11 @@
+export { usePermission } from './hooks/usePermission.js';
+export { usePermissions } from './hooks/usePermissions.js';
+export type { PermissionsController, PermissionStatusMap, } from './hooks/usePermissions.js';
+export { PermissionGate } from './components/PermissionGate.js';
+export type { PermissionGateProps, RationaleControls, BlockedControls, } from './components/PermissionGate.js';
+export { PermissionProvider, PermissionContext } from './context.js';
+export type { PermissionProviderProps, PermissionContextValue, PermissionDefaults, } from './context.js';
+export { checkPermission, requestPermission, openAppSettings, } from './imperative.js';
+export { reactNativePermissionsAdapter } from './adapters/reactNativePermissions.js';
+export type { PermissionName, PermissionStatus, FlowPhase, PermissionController, PermissionAdapter, UsePermissionOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAAwB,CAAC;AACxD,YAAY,EACV,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,2BAAwB,CAAC;AAGhC,OAAO,EAAE,cAAc,EAAE,MAAM,gCAA6B,CAAC;AAC7D,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,GAChB,MAAM,gCAA6B,CAAC;AAGrC,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,cAAW,CAAC;AAClE,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,cAAW,CAAC;AAGnB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,iBAAc,CAAC;AAGtB,OAAO,EAAE,6BAA6B,EAAE,MAAM,sCAAmC,CAAC;AAElF,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,YAAS,CAAC"}