react-native-permission-gate 0.1.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 Emre Cengiz
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,225 @@
+# react-native-permission-gate
+
+[![npm version](https://img.shields.io/npm/v/react-native-permission-gate.svg)](https://www.npmjs.com/package/react-native-permission-gate)
+[![CI](https://github.com/cengizemre/react-native-permission-gate/actions/workflows/ci.yml/badge.svg)](https://github.com/cengizemre/react-native-permission-gate/actions/workflows/ci.yml)
+[![license](https://img.shields.io/npm/l/react-native-permission-gate.svg)](./LICENSE)
+[![types](https://img.shields.io/npm/types/react-native-permission-gate.svg)](./src/types.ts)
+
+Headless permission-flow orchestration for React Native: a state-machine hook, rationale gating, and a `<PermissionGate>` component. Bring your own UI.
+
+`react-native-permissions` gives you the native call. The flow around it - show a pre-prompt, request, detect "denied", route to Settings, re-check when the user comes back - is what everyone hand-writes in every app. This library is that flow, as a headless state machine. It renders nothing and ships no modals.
+
+```tsx
+const cam = usePermission('camera', { rationale: true });
+
+<Button title="Enable camera" onPress={cam.request} />;
+{cam.phase === 'rationale' && <MyPrePrompt onConfirm={cam.confirmRationale} onCancel={cam.cancelRationale} />}
+{cam.isBlocked && <MyBlockedNotice onOpenSettings={cam.openSettings} />}
+```
+
+---
+
+## Why
+
+- No baked-in modals or styles - it's headless, so you drive your own components off `status` / `phase`.
+- A real, testable state machine (`idle → rationale → requesting → settled`) instead of ad-hoc booleans.
+- One hook covers the whole flow: check, rationale pre-prompt, native prompt, blocked → Settings, and focus re-validation.
+- `request()` resolves with the final status, so it works imperatively (`await`) or declaratively (render on `phase`).
+- The core has zero native dependencies, so your flows unit-test without a device.
+- Full TypeScript with a normalized cross-platform status model.
+
+## Installation
+
+```sh
+yarn add react-native-permission-gate react-native-permissions
+# or
+npm install react-native-permission-gate react-native-permissions
+```
+
+`react-native-permissions` is a peer dependency and needs its own one-time native setup (iOS `Podfile` `setup_permissions` + `Info.plist` usage strings, Android manifest entries). Follow its [setup guide](https://github.com/zoontek/react-native-permissions#setup) - that's the only native step.
+
+## Quick start
+
+```tsx
+import { usePermission } from 'react-native-permission-gate';
+
+function CameraButton() {
+  const cam = usePermission('camera', { rationale: true });
+
+  return (
+    <>
+      <Button title="Enable camera" onPress={() => cam.request()} />
+
+      <Modal visible={cam.phase === 'rationale'} transparent>
+        <PrePrompt
+          onConfirm={cam.confirmRationale}
+          onCancel={cam.cancelRationale}
+        />
+      </Modal>
+
+      {cam.isBlocked && <BlockedNotice onPress={cam.openSettings} />}
+    </>
+  );
+}
+```
+
+Prefer a declarative gate? Same flow, less wiring:
+
+```tsx
+import { PermissionGate } from 'react-native-permission-gate';
+
+<PermissionGate
+  name="camera"
+  rationale={({ confirm, cancel }) => <PrePrompt onConfirm={confirm} onCancel={cancel} />}
+  blocked={({ openSettings }) => <BlockedNotice onPress={openSettings} />}
+  fallback={<Spinner />}
+>
+  <CameraView />
+</PermissionGate>
+```
+
+## Core concepts
+
+Two independent axes - kept separate on purpose:
+
+| `status` (the OS truth) | Meaning |
+| --- | --- |
+| `granted` | Access allowed |
+| `limited` | Partial access (iOS: selected photos/contacts) |
+| `requestable` | Not granted yet, but the OS prompt can still show |
+| `blocked` | Denied; the OS won't prompt again - only Settings helps |
+| `unavailable` | Not supported on this device/build |
+
+| `phase` (the flow position) | Meaning |
+| --- | --- |
+| `idle` | Nothing in flight |
+| `rationale` | Your pre-prompt is showing, awaiting the user's choice |
+| `requesting` | The native OS dialog is up |
+| `settled` | The flow finished - read `status` for the outcome |
+
+```mermaid
+stateDiagram-v2
+    [*] --> idle
+    idle --> rationale: request(), rationale on
+    idle --> requesting: request(), rationale off
+    rationale --> requesting: confirmRationale()
+    rationale --> idle: cancelRationale()
+    requesting --> settled: OS responds
+    settled --> settled: refresh() / app focus
+```
+
+When `request()` is called on a status that can't be prompted (`granted`, `blocked`, `limited`, `unavailable`), the machine settles immediately and resolves - so a `blocked` result is something you _react to_, never a dead end.
+
+## API
+
+### `usePermission(name, options?)`
+
+```ts
+const controller = usePermission('camera', {
+  rationale: false,          // gate the native prompt behind a `rationale` phase
+  revalidateOnFocus: true,   // re-check when the app returns to the foreground
+  requestOnMount: false,     // run the flow automatically on mount
+  onStatusChange: (s) => {}, // called when the resolved status changes
+  adapter,                   // override the backend (defaults to react-native-permissions)
+});
+```
+
+Returns a `PermissionController`:
+
+| Field | Type | Description |
+| --- | --- | --- |
+| `status` | `PermissionStatus` | Current OS truth |
+| `phase` | `FlowPhase` | Current flow position |
+| `isGranted` | `boolean` | `status === 'granted'` |
+| `isBlocked` | `boolean` | `status === 'blocked'` |
+| `request()` | `() => Promise<PermissionStatus>` | Run the flow; resolves with the final status |
+| `confirmRationale()` | `() => void` | Proceed from `rationale` to the native prompt |
+| `cancelRationale()` | `() => void` | Abort `rationale`, back to `idle` |
+| `openSettings()` | `() => Promise<void>` | Open this app's OS settings |
+| `refresh()` | `() => Promise<PermissionStatus>` | Re-check on demand |
+
+Concurrent/double `request()` calls are de-duplicated - a double-tap never fires two native prompts or orphans a promise.
+
+### `usePermissions(names, options?)`
+
+Aggregate variant for permissions acquired together (e.g. camera + microphone for video). One shared rationale gate, one `request()`, one status map. Pass a **stable / memoized** `names` array.
+
+```tsx
+const media = usePermissions(['camera', 'microphone'], { rationale: true });
+
+media.statuses; // { camera: 'granted', microphone: 'requestable' }
+media.allGranted; // every requested permission is granted
+media.anyBlocked; // at least one is blocked
+
+<Button title="Start recording" onPress={media.request} />;
+{media.phase === 'rationale' && (
+  <MediaPrePrompt onConfirm={media.confirmRationale} onCancel={media.cancelRationale} />
+)}
+```
+
+`request()` prompts each not-yet-granted permission in turn (behind the single shared rationale gate) and resolves with the final status map. Already-granted permissions are skipped; `allGranted` counts only `granted` as satisfied.
+
+### `<PermissionGate>`
+
+Declarative wrapper over the hook. Renders `children` once granted (or `limited`); otherwise renders your `rationale` / `blocked` / `fallback`. Pass a **function** as `children` to take full control for every state.
+
+Unlike the bare hook, the gate starts the request flow automatically on mount (`requestOnMount: true`) — override it via `options` if you want a manual trigger.
+
+```tsx
+<PermissionGate name="microphone" options={{ rationale: true }}>
+  {(p) => <Text>{p.status} / {p.phase}</Text>}
+</PermissionGate>
+```
+
+### `<PermissionProvider>`
+
+Optional. Sets a shared adapter and default options for the subtree - the hook works fine without it.
+
+```tsx
+<PermissionProvider defaults={{ rationale: true, revalidateOnFocus: true }}>
+  <App />
+</PermissionProvider>
+```
+
+### Imperative (outside React)
+
+For services, sagas, and utilities - the raw calls, no rationale UX:
+
+```ts
+import {
+  checkPermission,
+  requestPermission,
+  openAppSettings,
+} from 'react-native-permission-gate';
+
+const status = await checkPermission('camera');
+```
+
+## Supported permissions
+
+**Cross-platform:** `camera`, `microphone`, `photoLibrary`, `contacts`, `calendar`, `calendarWriteOnly`, `locationWhenInUse`, `locationAlways`, `notifications`, `bluetooth`, `motion`.
+
+**iOS only:** `photoLibraryAddOnly`, `mediaLibrary`, `reminders`, `speechRecognition`, `appTrackingTransparency`, `faceId`.
+
+**Android only:** `storageReadAudio`, `storageReadVideo`, `bodySensors`.
+
+Each alias maps to the correct native permission per platform; anything not meaningful on the current platform resolves to `unavailable`. Need more? Provide a custom `adapter` - or open an issue.
+
+## Testing your flows
+
+Because the core is adapter-agnostic, you can test permission logic with a mock adapter - no device, no native module:
+
+```ts
+const adapter: PermissionAdapter = {
+  isSupported: () => true,
+  check: async () => 'requestable',
+  request: async () => 'granted',
+  openSettings: async () => {},
+};
+
+const { result } = renderHook(() => usePermission('camera', { adapter }));
+```
+
+## License
+
+MIT © [Emre Cengiz](https://github.com/cengizemre)

package/lib/module/adapters/reactNativePermissions.js

@@ -0,0 +1,97 @@
+"use strict";
+
+import { Platform } from 'react-native';
+import { PERMISSIONS, RESULTS, check, request, checkNotifications, requestNotifications, openSettings } from 'react-native-permissions';
+const IOS = {
+  camera: PERMISSIONS.IOS.CAMERA,
+  microphone: PERMISSIONS.IOS.MICROPHONE,
+  photoLibrary: PERMISSIONS.IOS.PHOTO_LIBRARY,
+  photoLibraryAddOnly: PERMISSIONS.IOS.PHOTO_LIBRARY_ADD_ONLY,
+  mediaLibrary: PERMISSIONS.IOS.MEDIA_LIBRARY,
+  contacts: PERMISSIONS.IOS.CONTACTS,
+  calendar: PERMISSIONS.IOS.CALENDARS,
+  calendarWriteOnly: PERMISSIONS.IOS.CALENDARS_WRITE_ONLY,
+  reminders: PERMISSIONS.IOS.REMINDERS,
+  locationWhenInUse: PERMISSIONS.IOS.LOCATION_WHEN_IN_USE,
+  locationAlways: PERMISSIONS.IOS.LOCATION_ALWAYS,
+  bluetooth: PERMISSIONS.IOS.BLUETOOTH,
+  motion: PERMISSIONS.IOS.MOTION,
+  speechRecognition: PERMISSIONS.IOS.SPEECH_RECOGNITION,
+  appTrackingTransparency: PERMISSIONS.IOS.APP_TRACKING_TRANSPARENCY,
+  faceId: PERMISSIONS.IOS.FACE_ID
+  // Android-only aliases (storageReadAudio, storageReadVideo, bodySensors)
+  // resolve to unavailable here.
+};
+const ANDROID = {
+  camera: PERMISSIONS.ANDROID.CAMERA,
+  microphone: PERMISSIONS.ANDROID.RECORD_AUDIO,
+  photoLibrary: PERMISSIONS.ANDROID.READ_MEDIA_IMAGES,
+  storageReadAudio: PERMISSIONS.ANDROID.READ_MEDIA_AUDIO,
+  storageReadVideo: PERMISSIONS.ANDROID.READ_MEDIA_VIDEO,
+  contacts: PERMISSIONS.ANDROID.READ_CONTACTS,
+  calendar: PERMISSIONS.ANDROID.READ_CALENDAR,
+  calendarWriteOnly: PERMISSIONS.ANDROID.WRITE_CALENDAR,
+  locationWhenInUse: PERMISSIONS.ANDROID.ACCESS_FINE_LOCATION,
+  locationAlways: PERMISSIONS.ANDROID.ACCESS_BACKGROUND_LOCATION,
+  bluetooth: PERMISSIONS.ANDROID.BLUETOOTH_CONNECT,
+  motion: PERMISSIONS.ANDROID.ACTIVITY_RECOGNITION,
+  bodySensors: PERMISSIONS.ANDROID.BODY_SENSORS
+  // iOS-only aliases (photoLibraryAddOnly, mediaLibrary, reminders,
+  // speechRecognition, appTrackingTransparency, faceId) → unavailable here.
+};
+const TABLE = Platform.OS === 'ios' ? IOS : Platform.OS === 'android' ? ANDROID : {};
+function toStatus(result) {
+  switch (result) {
+    case RESULTS.GRANTED:
+      return 'granted';
+    case RESULTS.LIMITED:
+      return 'limited';
+    case RESULTS.BLOCKED:
+      return 'blocked';
+    case RESULTS.DENIED:
+      return 'requestable';
+    case RESULTS.UNAVAILABLE:
+    default:
+      return 'unavailable';
+  }
+}
+
+/**
+ * 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 const reactNativePermissionsAdapter = {
+  isSupported(name) {
+    if (name === 'notifications') {
+      return Platform.OS === 'ios' || Platform.OS === 'android';
+    }
+    return TABLE[name] !== undefined;
+  },
+  async check(name) {
+    if (name === 'notifications') {
+      const {
+        status
+      } = await checkNotifications();
+      return toStatus(status);
+    }
+    const native = TABLE[name];
+    if (!native) return 'unavailable';
+    return toStatus(await check(native));
+  },
+  async request(name) {
+    if (name === 'notifications') {
+      const {
+        status
+      } = await requestNotifications(['alert', 'sound', 'badge']);
+      return toStatus(status);
+    }
+    const native = TABLE[name];
+    if (!native) return 'unavailable';
+    return toStatus(await request(native));
+  },
+  async openSettings() {
+    await openSettings();
+  }
+};
+//# sourceMappingURL=reactNativePermissions.js.map

package/lib/module/adapters/reactNativePermissions.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Platform","PERMISSIONS","RESULTS","check","request","checkNotifications","requestNotifications","openSettings","IOS","camera","CAMERA","microphone","MICROPHONE","photoLibrary","PHOTO_LIBRARY","photoLibraryAddOnly","PHOTO_LIBRARY_ADD_ONLY","mediaLibrary","MEDIA_LIBRARY","contacts","CONTACTS","calendar","CALENDARS","calendarWriteOnly","CALENDARS_WRITE_ONLY","reminders","REMINDERS","locationWhenInUse","LOCATION_WHEN_IN_USE","locationAlways","LOCATION_ALWAYS","bluetooth","BLUETOOTH","motion","MOTION","speechRecognition","SPEECH_RECOGNITION","appTrackingTransparency","APP_TRACKING_TRANSPARENCY","faceId","FACE_ID","ANDROID","RECORD_AUDIO","READ_MEDIA_IMAGES","storageReadAudio","READ_MEDIA_AUDIO","storageReadVideo","READ_MEDIA_VIDEO","READ_CONTACTS","READ_CALENDAR","WRITE_CALENDAR","ACCESS_FINE_LOCATION","ACCESS_BACKGROUND_LOCATION","BLUETOOTH_CONNECT","ACTIVITY_RECOGNITION","bodySensors","BODY_SENSORS","TABLE","OS","toStatus","result","GRANTED","LIMITED","BLOCKED","DENIED","UNAVAILABLE","reactNativePermissionsAdapter","isSupported","name","undefined","status","native"],"sourceRoot":"../../../src","sources":["adapters/reactNativePermissions.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/components/PermissionGate.js

@@ -0,0 +1,60 @@
+"use strict";
+
+import { usePermission } from "../hooks/usePermission.js";
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * 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 function PermissionGate({
+  name,
+  options,
+  children,
+  rationale,
+  blocked,
+  fallback = null
+}) {
+  const controller = usePermission(name, {
+    requestOnMount: true,
+    ...options
+  });
+
+  // Render-prop mode: hand over full control regardless of status.
+  if (typeof children === 'function') {
+    return /*#__PURE__*/_jsx(_Fragment, {
+      children: children(controller)
+    });
+  }
+  const {
+    status,
+    phase,
+    isBlocked
+  } = controller;
+  if (status === 'granted' || status === 'limited') {
+    return /*#__PURE__*/_jsx(_Fragment, {
+      children: children
+    });
+  }
+  if (phase === 'rationale' && rationale) {
+    return /*#__PURE__*/_jsx(_Fragment, {
+      children: rationale({
+        confirm: controller.confirmRationale,
+        cancel: controller.cancelRationale,
+        status
+      })
+    });
+  }
+  if (isBlocked && blocked) {
+    return /*#__PURE__*/_jsx(_Fragment, {
+      children: blocked({
+        openSettings: controller.openSettings,
+        status
+      })
+    });
+  }
+  return /*#__PURE__*/_jsx(_Fragment, {
+    children: fallback
+  });
+}
+//# sourceMappingURL=PermissionGate.js.map

package/lib/module/components/PermissionGate.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["usePermission","Fragment","_Fragment","jsx","_jsx","PermissionGate","name","options","children","rationale","blocked","fallback","controller","requestOnMount","status","phase","isBlocked","confirm","confirmRationale","cancel","cancelRationale","openSettings"],"sourceRoot":"../../../src","sources":["components/PermissionGate.tsx"],"mappings":";;AACA,SAASA,aAAa,QAAQ,2BAAwB;AAAC,SAAAC,QAAA,IAAAC,SAAA,EAAAC,GAAA,IAAAC,IAAA;AAoCvD;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAC;EAC7BC,IAAI;EACJC,OAAO;EACPC,QAAQ;EACRC,SAAS;EACTC,OAAO;EACPC,QAAQ,GAAG;AACQ,CAAC,EAAE;EACtB,MAAMC,UAAU,GAAGZ,aAAa,CAACM,IAAI,EAAE;IAAEO,cAAc,EAAE,IAAI;IAAE,GAAGN;EAAQ,CAAC,CAAC;;EAE5E;EACA,IAAI,OAAOC,QAAQ,KAAK,UAAU,EAAE;IAClC,oBAAOJ,IAAA,CAAAF,SAAA;MAAAM,QAAA,EAAGA,QAAQ,CAACI,UAAU;IAAC,CAAG,CAAC;EACpC;EAEA,MAAM;IAAEE,MAAM;IAAEC,KAAK;IAAEC;EAAU,CAAC,GAAGJ,UAAU;EAE/C,IAAIE,MAAM,KAAK,SAAS,IAAIA,MAAM,KAAK,SAAS,EAAE;IAChD,oBAAOV,IAAA,CAAAF,SAAA;MAAAM,QAAA,EAAGA;IAAQ,CAAG,CAAC;EACxB;EAEA,IAAIO,KAAK,KAAK,WAAW,IAAIN,SAAS,EAAE;IACtC,oBACEL,IAAA,CAAAF,SAAA;MAAAM,QAAA,EACGC,SAAS,CAAC;QACTQ,OAAO,EAAEL,UAAU,CAACM,gBAAgB;QACpCC,MAAM,EAAEP,UAAU,CAACQ,eAAe;QAClCN;MACF,CAAC;IAAC,CACF,CAAC;EAEP;EAEA,IAAIE,SAAS,IAAIN,OAAO,EAAE;IACxB,oBAAON,IAAA,CAAAF,SAAA;MAAAM,QAAA,EAAGE,OAAO,CAAC;QAAEW,YAAY,EAAET,UAAU,CAACS,YAAY;QAAEP;MAAO,CAAC;IAAC,CAAG,CAAC;EAC1E;EAEA,oBAAOV,IAAA,CAAAF,SAAA;IAAAM,QAAA,EAAGG;EAAQ,CAAG,CAAC;AACxB","ignoreList":[]}

package/lib/module/context.js

@@ -0,0 +1,29 @@
+"use strict";
+
+import { createContext } from 'react';
+import { reactNativePermissionsAdapter } from "./adapters/reactNativePermissions.js";
+
+/** Options that can be defaulted for every hook/component under a provider. */
+import { jsx as _jsx } from "react/jsx-runtime";
+export const PermissionContext = /*#__PURE__*/createContext({
+  adapter: reactNativePermissionsAdapter,
+  defaults: {}
+});
+/**
+ * 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 function PermissionProvider({
+  adapter = reactNativePermissionsAdapter,
+  defaults = {},
+  children
+}) {
+  return /*#__PURE__*/_jsx(PermissionContext.Provider, {
+    value: {
+      adapter,
+      defaults
+    },
+    children: children
+  });
+}
+//# sourceMappingURL=context.js.map

package/lib/module/context.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createContext","reactNativePermissionsAdapter","jsx","_jsx","PermissionContext","adapter","defaults","PermissionProvider","children","Provider","value"],"sourceRoot":"../../src","sources":["context.tsx"],"mappings":";;AAAA,SAASA,aAAa,QAAwB,OAAO;AACrD,SAASC,6BAA6B,QAAQ,sCAAmC;;AAGjF;AAAA,SAAAC,GAAA,IAAAC,IAAA;AAWA,OAAO,MAAMC,iBAAiB,gBAAGJ,aAAa,CAAyB;EACrEK,OAAO,EAAEJ,6BAA6B;EACtCK,QAAQ,EAAE,CAAC;AACb,CAAC,CAAC;AAUF;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAAC;EACjCF,OAAO,GAAGJ,6BAA6B;EACvCK,QAAQ,GAAG,CAAC,CAAC;EACbE;AACuB,CAAC,EAAE;EAC1B,oBACEL,IAAA,CAACC,iBAAiB,CAACK,QAAQ;IAACC,KAAK,EAAE;MAAEL,OAAO;MAAEC;IAAS,CAAE;IAAAE,QAAA,EACtDA;EAAQ,CACiB,CAAC;AAEjC","ignoreList":[]}

package/lib/module/core/machine.js

@@ -0,0 +1,107 @@
+"use strict";
+
+/**
+ * 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.
+ */
+
+const noop = state => ({
+  state,
+  effects: []
+});
+export function reduce(state, event, ctx) {
+  switch (event.type) {
+    case 'REQUEST':
+      {
+        // Only `requestable` can produce an OS prompt. Every other status is
+        // terminal for a request (granted/limited/blocked/unavailable): settle
+        // immediately so callers can react (e.g. show a "go to Settings" UI when
+        // blocked) without a dead-end.
+        if (state.status !== 'requestable') {
+          return {
+            state: {
+              ...state,
+              phase: 'settled'
+            },
+            effects: [{
+              type: 'resolve',
+              status: state.status
+            }]
+          };
+        }
+        if (ctx.rationale) {
+          return {
+            state: {
+              ...state,
+              phase: 'rationale'
+            },
+            effects: []
+          };
+        }
+        return {
+          state: {
+            ...state,
+            phase: 'requesting'
+          },
+          effects: [{
+            type: 'runRequest'
+          }]
+        };
+      }
+    case 'CONFIRM_RATIONALE':
+      {
+        if (state.phase !== 'rationale') return noop(state);
+        return {
+          state: {
+            ...state,
+            phase: 'requesting'
+          },
+          effects: [{
+            type: 'runRequest'
+          }]
+        };
+      }
+    case 'CANCEL_RATIONALE':
+      {
+        if (state.phase !== 'rationale') return noop(state);
+        return {
+          state: {
+            ...state,
+            phase: 'idle'
+          },
+          effects: [{
+            type: 'resolve',
+            status: state.status
+          }]
+        };
+      }
+    case 'REQUEST_RESULT':
+      {
+        return {
+          state: {
+            status: event.status,
+            phase: 'settled'
+          },
+          effects: [{
+            type: 'resolve',
+            status: event.status
+          }]
+        };
+      }
+    case 'CHECK_RESULT':
+    case 'REFRESH_RESULT':
+      {
+        // Update the known status without disturbing an in-flight phase.
+        return noop({
+          ...state,
+          status: event.status
+        });
+      }
+    default:
+      return noop(state);
+  }
+}
+//# sourceMappingURL=machine.js.map

package/lib/module/core/machine.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["noop","state","effects","reduce","event","ctx","type","status","phase","rationale"],"sourceRoot":"../../../src","sources":["core/machine.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;;AA6BA,MAAMA,IAAI,GAAIC,KAAmB,KAAkB;EAAEA,KAAK;EAAEC,OAAO,EAAE;AAAG,CAAC,CAAC;AAE1E,OAAO,SAASC,MAAMA,CACpBF,KAAmB,EACnBG,KAAmB,EACnBC,GAAmB,EACP;EACZ,QAAQD,KAAK,CAACE,IAAI;IAChB,KAAK,SAAS;MAAE;QACd;QACA;QACA;QACA;QACA,IAAIL,KAAK,CAACM,MAAM,KAAK,aAAa,EAAE;UAClC,OAAO;YACLN,KAAK,EAAE;cAAE,GAAGA,KAAK;cAAEO,KAAK,EAAE;YAAU,CAAC;YACrCN,OAAO,EAAE,CAAC;cAAEI,IAAI,EAAE,SAAS;cAAEC,MAAM,EAAEN,KAAK,CAACM;YAAO,CAAC;UACrD,CAAC;QACH;QACA,IAAIF,GAAG,CAACI,SAAS,EAAE;UACjB,OAAO;YAAER,KAAK,EAAE;cAAE,GAAGA,KAAK;cAAEO,KAAK,EAAE;YAAY,CAAC;YAAEN,OAAO,EAAE;UAAG,CAAC;QACjE;QACA,OAAO;UACLD,KAAK,EAAE;YAAE,GAAGA,KAAK;YAAEO,KAAK,EAAE;UAAa,CAAC;UACxCN,OAAO,EAAE,CAAC;YAAEI,IAAI,EAAE;UAAa,CAAC;QAClC,CAAC;MACH;IAEA,KAAK,mBAAmB;MAAE;QACxB,IAAIL,KAAK,CAACO,KAAK,KAAK,WAAW,EAAE,OAAOR,IAAI,CAACC,KAAK,CAAC;QACnD,OAAO;UACLA,KAAK,EAAE;YAAE,GAAGA,KAAK;YAAEO,KAAK,EAAE;UAAa,CAAC;UACxCN,OAAO,EAAE,CAAC;YAAEI,IAAI,EAAE;UAAa,CAAC;QAClC,CAAC;MACH;IAEA,KAAK,kBAAkB;MAAE;QACvB,IAAIL,KAAK,CAACO,KAAK,KAAK,WAAW,EAAE,OAAOR,IAAI,CAACC,KAAK,CAAC;QACnD,OAAO;UACLA,KAAK,EAAE;YAAE,GAAGA,KAAK;YAAEO,KAAK,EAAE;UAAO,CAAC;UAClCN,OAAO,EAAE,CAAC;YAAEI,IAAI,EAAE,SAAS;YAAEC,MAAM,EAAEN,KAAK,CAACM;UAAO,CAAC;QACrD,CAAC;MACH;IAEA,KAAK,gBAAgB;MAAE;QACrB,OAAO;UACLN,KAAK,EAAE;YAAEM,MAAM,EAAEH,KAAK,CAACG,MAAM;YAAEC,KAAK,EAAE;UAAU,CAAC;UACjDN,OAAO,EAAE,CAAC;YAAEI,IAAI,EAAE,SAAS;YAAEC,MAAM,EAAEH,KAAK,CAACG;UAAO,CAAC;QACrD,CAAC;MACH;IAEA,KAAK,cAAc;IACnB,KAAK,gBAAgB;MAAE;QACrB;QACA,OAAOP,IAAI,CAAC;UAAE,GAAGC,KAAK;UAAEM,MAAM,EAAEH,KAAK,CAACG;QAAO,CAAC,CAAC;MACjD;IAEA;MACE,OAAOP,IAAI,CAACC,KAAK,CAAC;EACtB;AACF","ignoreList":[]}