@ankhorage/permissions 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @ankhorage/permissions
 
+## 0.2.3
+
+### Patch Changes
+
+- 8ee977d: Normalize blocked and partial Expo authorization states, project the Expo client dependency,
+  and add settings recovery with a stable failure contract.
+
 ## 0.2.2
 
 ### Patch Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # PERMISSIONS
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v0.2.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v0.2.2](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
 
 Cross-platform permission registry and runtime helpers for Expo, React Native, and React Native Web apps, with unified request/check APIs for camera, media, location, notifications, microphone, and other web/native capabilities.
 
@@ -137,6 +137,30 @@ Related symbols: `FakePermissionClient`, `FakePermissionClientOptions`
 
 </details>
 
+<details>
+<summary>createPermissionClient</summary>
+
+```ts
+createPermissionClient() => PermissionClient
+```
+
+Creates a permission client backed by Expo SDK modules.
+
+Denials that Expo cannot request again are normalized to `blocked`. Limited
+media-library access and provisional or ephemeral iOS notification access
+are normalized to usable `limited` states, where `granted` remains true.
+The client requires `expo-linking` for settings recovery and rejects with a
+stable error when the operating-system settings page cannot be opened.
+
+Expo modules are loaded only when a client operation uses them. The package
+root and Expo manifest metadata remain free of native module imports.
+
+Module: `src/expo/client.ts`
+Source: `src/expo/client.ts:42:1`
+Related symbols: `PermissionClient`
+
+</details>
+
 <details>
 <summary>createPermissionManager</summary>
 

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from '../ankh.provider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,2 @@
+export { default } from '../ankh.provider.js';
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC","sourcesContent":["export { default } from '../ankh.provider.js';\n"]}

package/dist/expo/adapters/mediaLibrary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mediaLibrary.d.ts","sourceRoot":"","sources":["../../../src/expo/adapters/mediaLibrary.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAGvD,eAAO,MAAM,mBAAmB,EAAE,qBAsBjC,CAAC"}
+{"version":3,"file":"mediaLibrary.d.ts","sourceRoot":"","sources":["../../../src/expo/adapters/mediaLibrary.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAWvD,eAAO,MAAM,mBAAmB,EAAE,qBAsBjC,CAAC"}

package/dist/expo/adapters/mediaLibrary.js

@@ -1,11 +1,12 @@
 import { Permission as KnownPermission } from '../../registry/permissions';
-import { createExpoPermissionState, createExpoUnavailableState } from '../permissionResponse';
+import { createPermissionState } from '../../state/permissionState';
+import { createExpoPermissionState, createExpoUnavailableState, } from '../permissionResponse';
 export const mediaLibraryAdapter = {
     async getStatus(permission) {
         try {
             const mod = await import('expo-media-library');
             const result = await mod.getPermissionsAsync(isWriteOnlyPermission(permission));
-            return createExpoPermissionState(permission, result);
+            return createMediaLibraryPermissionState(permission, result);
         }
         catch (error) {
             return createExpoUnavailableState(permission, error);
@@ -15,13 +16,24 @@ export const mediaLibraryAdapter = {
         try {
             const mod = await import('expo-media-library');
             const result = await mod.requestPermissionsAsync(isWriteOnlyPermission(permission));
-            return createExpoPermissionState(permission, result);
+            return createMediaLibraryPermissionState(permission, result);
         }
         catch (error) {
             return createExpoUnavailableState(permission, error);
         }
     },
 };
+function createMediaLibraryPermissionState(permission, response) {
+    if (response.accessPrivileges !== 'limited') {
+        return createExpoPermissionState(permission, response);
+    }
+    return createPermissionState({
+        permission,
+        status: 'limited',
+        canAskAgain: response.canAskAgain,
+        reason: 'Media library access is limited to user-selected assets.',
+    });
+}
 function isWriteOnlyPermission(permission) {
     return permission === KnownPermission.MediaLibraryWrite;
 }

package/dist/expo/adapters/mediaLibrary.js.map

@@ -1 +1 @@
-{"version":3,"file":"mediaLibrary.js","sourceRoot":"","sources":["../../../src/expo/adapters/mediaLibrary.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,IAAI,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG3E,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAE9F,MAAM,CAAC,MAAM,mBAAmB,GAA0B;IACxD,KAAK,CAAC,SAAS,CAAC,UAAsB;QACpC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC,CAAC;YAEhF,OAAO,yBAAyB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,0BAA0B,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAsB;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,uBAAuB,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC,CAAC;YAEpF,OAAO,yBAAyB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,0BAA0B,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF,CAAC;AAEF,SAAS,qBAAqB,CAAC,UAAsB;IACnD,OAAO,UAAU,KAAK,eAAe,CAAC,iBAAiB,CAAC;AAC1D,CAAC","sourcesContent":["import type { Permission } from '../../registry/permissions';\nimport { Permission as KnownPermission } from '../../registry/permissions';\nimport type { PermissionState } from '../../state/permissionState';\nimport type { ExpoPermissionAdapter } from '../client';\nimport { createExpoPermissionState, createExpoUnavailableState } from '../permissionResponse';\n\nexport const mediaLibraryAdapter: ExpoPermissionAdapter = {\n  async getStatus(permission: Permission): Promise<PermissionState> {\n    try {\n      const mod = await import('expo-media-library');\n      const result = await mod.getPermissionsAsync(isWriteOnlyPermission(permission));\n\n      return createExpoPermissionState(permission, result);\n    } catch (error) {\n      return createExpoUnavailableState(permission, error);\n    }\n  },\n\n  async request(permission: Permission): Promise<PermissionState> {\n    try {\n      const mod = await import('expo-media-library');\n      const result = await mod.requestPermissionsAsync(isWriteOnlyPermission(permission));\n\n      return createExpoPermissionState(permission, result);\n    } catch (error) {\n      return createExpoUnavailableState(permission, error);\n    }\n  },\n};\n\nfunction isWriteOnlyPermission(permission: Permission): boolean {\n  return permission === KnownPermission.MediaLibraryWrite;\n}\n"]}
+{"version":3,"file":"mediaLibrary.js","sourceRoot":"","sources":["../../../src/expo/adapters/mediaLibrary.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,IAAI,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAwB,MAAM,6BAA6B,CAAC;AAE1F,OAAO,EACL,yBAAyB,EACzB,0BAA0B,GAE3B,MAAM,uBAAuB,CAAC;AAM/B,MAAM,CAAC,MAAM,mBAAmB,GAA0B;IACxD,KAAK,CAAC,SAAS,CAAC,UAAsB;QACpC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC,CAAC;YAEhF,OAAO,iCAAiC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,0BAA0B,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAsB;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,uBAAuB,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC,CAAC;YAEpF,OAAO,iCAAiC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,0BAA0B,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF,CAAC;AAEF,SAAS,iCAAiC,CACxC,UAAsB,EACtB,QAA4C;IAE5C,IAAI,QAAQ,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC5C,OAAO,yBAAyB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,qBAAqB,CAAC;QAC3B,UAAU;QACV,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,MAAM,EAAE,0DAA0D;KACnE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,UAAsB;IACnD,OAAO,UAAU,KAAK,eAAe,CAAC,iBAAiB,CAAC;AAC1D,CAAC","sourcesContent":["import type { Permission } from '../../registry/permissions';\nimport { Permission as KnownPermission } from '../../registry/permissions';\nimport { createPermissionState, type PermissionState } from '../../state/permissionState';\nimport type { ExpoPermissionAdapter } from '../client';\nimport {\n  createExpoPermissionState,\n  createExpoUnavailableState,\n  type ExpoPermissionResponse,\n} from '../permissionResponse';\n\ninterface ExpoMediaLibraryPermissionResponse extends ExpoPermissionResponse {\n  readonly accessPrivileges?: 'all' | 'limited' | 'none';\n}\n\nexport const mediaLibraryAdapter: ExpoPermissionAdapter = {\n  async getStatus(permission: Permission): Promise<PermissionState> {\n    try {\n      const mod = await import('expo-media-library');\n      const result = await mod.getPermissionsAsync(isWriteOnlyPermission(permission));\n\n      return createMediaLibraryPermissionState(permission, result);\n    } catch (error) {\n      return createExpoUnavailableState(permission, error);\n    }\n  },\n\n  async request(permission: Permission): Promise<PermissionState> {\n    try {\n      const mod = await import('expo-media-library');\n      const result = await mod.requestPermissionsAsync(isWriteOnlyPermission(permission));\n\n      return createMediaLibraryPermissionState(permission, result);\n    } catch (error) {\n      return createExpoUnavailableState(permission, error);\n    }\n  },\n};\n\nfunction createMediaLibraryPermissionState(\n  permission: Permission,\n  response: ExpoMediaLibraryPermissionResponse,\n): PermissionState {\n  if (response.accessPrivileges !== 'limited') {\n    return createExpoPermissionState(permission, response);\n  }\n\n  return createPermissionState({\n    permission,\n    status: 'limited',\n    canAskAgain: response.canAskAgain,\n    reason: 'Media library access is limited to user-selected assets.',\n  });\n}\n\nfunction isWriteOnlyPermission(permission: Permission): boolean {\n  return permission === KnownPermission.MediaLibraryWrite;\n}\n"]}

package/dist/expo/adapters/notifications.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../../src/expo/adapters/notifications.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAGvD,eAAO,MAAM,oBAAoB,EAAE,qBAsBlC,CAAC"}
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../../src/expo/adapters/notifications.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAavD,eAAO,MAAM,oBAAoB,EAAE,qBAsBlC,CAAC"}

package/dist/expo/adapters/notifications.js

@@ -1,10 +1,11 @@
-import { createExpoPermissionState, createExpoUnavailableState } from '../permissionResponse';
+import { createPermissionState } from '../../state/permissionState';
+import { createExpoPermissionState, createExpoUnavailableState, } from '../permissionResponse';
 export const notificationsAdapter = {
     async getStatus(permission) {
         try {
             const mod = await import('expo-notifications');
             const result = await mod.getPermissionsAsync();
-            return createExpoPermissionState(permission, result);
+            return createNotificationPermissionState(permission, result);
         }
         catch (error) {
             return createExpoUnavailableState(permission, error);
@@ -14,11 +15,39 @@ export const notificationsAdapter = {
         try {
             const mod = await import('expo-notifications');
             const result = await mod.requestPermissionsAsync();
-            return createExpoPermissionState(permission, result);
+            return createNotificationPermissionState(permission, result);
         }
         catch (error) {
             return createExpoUnavailableState(permission, error);
         }
     },
 };
+function createNotificationPermissionState(permission, response) {
+    switch (response.ios?.status) {
+        case 0:
+            return createNotificationState(permission, response, 'unknown', 'iOS notification authorization has not been determined.');
+        case 1:
+            return createNotificationState(permission, response, 'denied', 'iOS notification authorization is denied.');
+        case 2:
+            return createNotificationState(permission, response, 'granted');
+        case 3:
+            return createNotificationState(permission, response, 'limited', 'iOS notification authorization is provisional.');
+        case 4:
+            return createNotificationState(permission, response, 'limited', 'iOS notification authorization is ephemeral.');
+        default:
+            return createExpoPermissionState(permission, response);
+    }
+}
+function createNotificationState(permission, response, status, reason) {
+    const state = createExpoPermissionState(permission, {
+        status,
+        canAskAgain: response.canAskAgain,
+    });
+    return createPermissionState({
+        permission,
+        status: state.status,
+        canAskAgain: state.canAskAgain,
+        reason: state.reason ?? reason,
+    });
+}
 //# sourceMappingURL=notifications.js.map

package/dist/expo/adapters/notifications.js.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../../../src/expo/adapters/notifications.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAE9F,MAAM,CAAC,MAAM,oBAAoB,GAA0B;IACzD,KAAK,CAAC,SAAS,CAAC,UAAsB;QACpC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,mBAAmB,EAAE,CAAC;YAE/C,OAAO,yBAAyB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,0BAA0B,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAsB;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,uBAAuB,EAAE,CAAC;YAEnD,OAAO,yBAAyB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,0BAA0B,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF,CAAC","sourcesContent":["import type { Permission } from '../../registry/permissions';\nimport type { PermissionState } from '../../state/permissionState';\nimport type { ExpoPermissionAdapter } from '../client';\nimport { createExpoPermissionState, createExpoUnavailableState } from '../permissionResponse';\n\nexport const notificationsAdapter: ExpoPermissionAdapter = {\n  async getStatus(permission: Permission): Promise<PermissionState> {\n    try {\n      const mod = await import('expo-notifications');\n      const result = await mod.getPermissionsAsync();\n\n      return createExpoPermissionState(permission, result);\n    } catch (error) {\n      return createExpoUnavailableState(permission, error);\n    }\n  },\n\n  async request(permission: Permission): Promise<PermissionState> {\n    try {\n      const mod = await import('expo-notifications');\n      const result = await mod.requestPermissionsAsync();\n\n      return createExpoPermissionState(permission, result);\n    } catch (error) {\n      return createExpoUnavailableState(permission, error);\n    }\n  },\n};\n"]}
+{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../../../src/expo/adapters/notifications.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAwB,MAAM,6BAA6B,CAAC;AAE1F,OAAO,EACL,yBAAyB,EACzB,0BAA0B,GAE3B,MAAM,uBAAuB,CAAC;AAQ/B,MAAM,CAAC,MAAM,oBAAoB,GAA0B;IACzD,KAAK,CAAC,SAAS,CAAC,UAAsB;QACpC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,mBAAmB,EAAE,CAAC;YAE/C,OAAO,iCAAiC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,0BAA0B,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAsB;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,uBAAuB,EAAE,CAAC;YAEnD,OAAO,iCAAiC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,0BAA0B,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF,CAAC;AAEF,SAAS,iCAAiC,CACxC,UAAsB,EACtB,QAA4C;IAE5C,QAAQ,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC;QAC7B,KAAK,CAAC;YACJ,OAAO,uBAAuB,CAC5B,UAAU,EACV,QAAQ,EACR,SAAS,EACT,yDAAyD,CAC1D,CAAC;QACJ,KAAK,CAAC;YACJ,OAAO,uBAAuB,CAC5B,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,2CAA2C,CAC5C,CAAC;QACJ,KAAK,CAAC;YACJ,OAAO,uBAAuB,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QAClE,KAAK,CAAC;YACJ,OAAO,uBAAuB,CAC5B,UAAU,EACV,QAAQ,EACR,SAAS,EACT,gDAAgD,CACjD,CAAC;QACJ,KAAK,CAAC;YACJ,OAAO,uBAAuB,CAC5B,UAAU,EACV,QAAQ,EACR,SAAS,EACT,8CAA8C,CAC/C,CAAC;QACJ;YACE,OAAO,yBAAyB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAC9B,UAAsB,EACtB,QAA4C,EAC5C,MAAiC,EACjC,MAAe;IAEf,MAAM,KAAK,GAAG,yBAAyB,CAAC,UAAU,EAAE;QAClD,MAAM;QACN,WAAW,EAAE,QAAQ,CAAC,WAAW;KAClC,CAAC,CAAC;IAEH,OAAO,qBAAqB,CAAC;QAC3B,UAAU;QACV,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,MAAM;KAC/B,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Permission } from '../../registry/permissions';\nimport { createPermissionState, type PermissionState } from '../../state/permissionState';\nimport type { ExpoPermissionAdapter } from '../client';\nimport {\n  createExpoPermissionState,\n  createExpoUnavailableState,\n  type ExpoPermissionResponse,\n} from '../permissionResponse';\n\ninterface ExpoNotificationPermissionResponse extends ExpoPermissionResponse {\n  readonly ios?: {\n    readonly status?: number;\n  };\n}\n\nexport const notificationsAdapter: ExpoPermissionAdapter = {\n  async getStatus(permission: Permission): Promise<PermissionState> {\n    try {\n      const mod = await import('expo-notifications');\n      const result = await mod.getPermissionsAsync();\n\n      return createNotificationPermissionState(permission, result);\n    } catch (error) {\n      return createExpoUnavailableState(permission, error);\n    }\n  },\n\n  async request(permission: Permission): Promise<PermissionState> {\n    try {\n      const mod = await import('expo-notifications');\n      const result = await mod.requestPermissionsAsync();\n\n      return createNotificationPermissionState(permission, result);\n    } catch (error) {\n      return createExpoUnavailableState(permission, error);\n    }\n  },\n};\n\nfunction createNotificationPermissionState(\n  permission: Permission,\n  response: ExpoNotificationPermissionResponse,\n): PermissionState {\n  switch (response.ios?.status) {\n    case 0:\n      return createNotificationState(\n        permission,\n        response,\n        'unknown',\n        'iOS notification authorization has not been determined.',\n      );\n    case 1:\n      return createNotificationState(\n        permission,\n        response,\n        'denied',\n        'iOS notification authorization is denied.',\n      );\n    case 2:\n      return createNotificationState(permission, response, 'granted');\n    case 3:\n      return createNotificationState(\n        permission,\n        response,\n        'limited',\n        'iOS notification authorization is provisional.',\n      );\n    case 4:\n      return createNotificationState(\n        permission,\n        response,\n        'limited',\n        'iOS notification authorization is ephemeral.',\n      );\n    default:\n      return createExpoPermissionState(permission, response);\n  }\n}\n\nfunction createNotificationState(\n  permission: Permission,\n  response: ExpoNotificationPermissionResponse,\n  status: PermissionState['status'],\n  reason?: string,\n): PermissionState {\n  const state = createExpoPermissionState(permission, {\n    status,\n    canAskAgain: response.canAskAgain,\n  });\n\n  return createPermissionState({\n    permission,\n    status: state.status,\n    canAskAgain: state.canAskAgain,\n    reason: state.reason ?? reason,\n  });\n}\n"]}

package/dist/expo/client.d.ts

@@ -5,5 +5,19 @@ export interface ExpoPermissionAdapter {
     getStatus(permission: Permission): Promise<PermissionState>;
     request(permission: Permission): Promise<PermissionState>;
 }
+/***
+ * Creates a permission client backed by Expo SDK modules.
+ *
+ * Denials that Expo cannot request again are normalized to `blocked`. Limited
+ * media-library access and provisional or ephemeral iOS notification access
+ * are normalized to usable `limited` states, where `granted` remains true.
+ * The client requires `expo-linking` for settings recovery and rejects with a
+ * stable error when the operating-system settings page cannot be opened.
+ *
+ * Expo modules are loaded only when a client operation uses them. The package
+ * root and Expo manifest metadata remain free of native module imports.
+ *
+ * @readme
+ */
 export declare function createPermissionClient(): PermissionClient;
 //# sourceMappingURL=client.d.ts.map

package/dist/expo/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/expo/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAQvF,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5D,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC3D;AAYD,wBAAgB,sBAAsB,IAAI,gBAAgB,CAsCzD"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/expo/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAUvF,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5D,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC3D;AAYD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAkDzD"}

package/dist/expo/client.js

@@ -6,6 +6,7 @@ import { mediaLibraryAdapter } from './adapters/mediaLibrary';
 import { microphoneAdapter } from './adapters/microphone';
 import { notificationsAdapter } from './adapters/notifications';
 import { EXPO_PERMISSION_SUPPORT } from './manifest';
+const OPEN_SETTINGS_ERROR_MESSAGE = 'Unable to open application settings.';
 const adapters = {
     [Permission.Camera]: cameraAdapter,
     [Permission.MediaLibrary]: mediaLibraryAdapter,
@@ -15,6 +16,20 @@ const adapters = {
     [Permission.LocationBackground]: locationAdapter,
     [Permission.Notifications]: notificationsAdapter,
 };
+/***
+ * Creates a permission client backed by Expo SDK modules.
+ *
+ * Denials that Expo cannot request again are normalized to `blocked`. Limited
+ * media-library access and provisional or ephemeral iOS notification access
+ * are normalized to usable `limited` states, where `granted` remains true.
+ * The client requires `expo-linking` for settings recovery and rejects with a
+ * stable error when the operating-system settings page cannot be opened.
+ *
+ * Expo modules are loaded only when a client operation uses them. The package
+ * root and Expo manifest metadata remain free of native module imports.
+ *
+ * @readme
+ */
 export function createPermissionClient() {
     return {
         async getStatus(permission) {
@@ -45,6 +60,17 @@ export function createPermissionClient() {
             }
             return adapter.request(permission);
         },
+        async openSettings() {
+            try {
+                const linking = await import('expo-linking');
+                await linking.openSettings();
+            }
+            catch (error) {
+                throw new Error(OPEN_SETTINGS_ERROR_MESSAGE, {
+                    cause: error,
+                });
+            }
+        },
     };
 }
 function createUnavailableSupportState(permission) {

package/dist/expo/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/expo/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAwB,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAOrD,MAAM,QAAQ,GAAuD;IACnE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,aAAa;IAClC,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,mBAAmB;IAC9C,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,mBAAmB;IACnD,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,iBAAiB;IAC1C,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,eAAe;IAChD,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,eAAe;IAChD,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,oBAAoB;CACjD,CAAC;AAEF,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,KAAK,CAAC,SAAS,CAAC,UAAsB;YACpC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;YACrD,IAAI,QAAQ,CAAC,OAAO,KAAK,aAAa,IAAI,QAAQ,CAAC,OAAO,KAAK,gBAAgB,EAAE,CAAC;gBAChF,OAAO,6BAA6B,CAAC,UAAU,CAAC,CAAC;YACnD,CAAC;YAED,IAAI,QAAQ,CAAC,OAAO,KAAK,aAAa,EAAE,CAAC;gBACvC,OAAO,sBAAsB,CAAC,UAAU,CAAC,CAAC;YAC5C,CAAC;YAED,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,yCAAyC,UAAU,EAAE,CAAC,CAAC;YACzE,CAAC;YAED,OAAO,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,UAAsB;YAClC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;YACrD,IAAI,QAAQ,CAAC,OAAO,KAAK,aAAa,IAAI,QAAQ,CAAC,OAAO,KAAK,gBAAgB,EAAE,CAAC;gBAChF,OAAO,6BAA6B,CAAC,UAAU,CAAC,CAAC;YACnD,CAAC;YAED,IAAI,QAAQ,CAAC,OAAO,KAAK,aAAa,EAAE,CAAC;gBACvC,OAAO,sBAAsB,CAAC,UAAU,CAAC,CAAC;YAC5C,CAAC;YAED,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,yCAAyC,UAAU,EAAE,CAAC,CAAC;YACzE,CAAC;YAED,OAAO,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,6BAA6B,CAAC,UAAsB;IAC3D,OAAO,qBAAqB,CAAC;QAC3B,UAAU;QACV,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,cAAc,UAAU,2CAA2C;KAC5E,CAAC,CAAC;AACL,CAAC;AAED,SAAS,sBAAsB,CAAC,UAAsB;IACpD,OAAO,qBAAqB,CAAC;QAC3B,UAAU;QACV,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { PermissionClient } from '../client/types';\nimport { Permission } from '../registry/permissions';\nimport { createPermissionState, type PermissionState } from '../state/permissionState';\nimport { cameraAdapter } from './adapters/camera';\nimport { locationAdapter } from './adapters/location';\nimport { mediaLibraryAdapter } from './adapters/mediaLibrary';\nimport { microphoneAdapter } from './adapters/microphone';\nimport { notificationsAdapter } from './adapters/notifications';\nimport { EXPO_PERMISSION_SUPPORT } from './manifest';\n\nexport interface ExpoPermissionAdapter {\n  getStatus(permission: Permission): Promise<PermissionState>;\n  request(permission: Permission): Promise<PermissionState>;\n}\n\nconst adapters: Partial<Record<Permission, ExpoPermissionAdapter>> = {\n  [Permission.Camera]: cameraAdapter,\n  [Permission.MediaLibrary]: mediaLibraryAdapter,\n  [Permission.MediaLibraryWrite]: mediaLibraryAdapter,\n  [Permission.Microphone]: microphoneAdapter,\n  [Permission.LocationForeground]: locationAdapter,\n  [Permission.LocationBackground]: locationAdapter,\n  [Permission.Notifications]: notificationsAdapter,\n};\n\nexport function createPermissionClient(): PermissionClient {\n  return {\n    async getStatus(permission: Permission): Promise<PermissionState> {\n      const metadata = EXPO_PERMISSION_SUPPORT[permission];\n      if (metadata.support === 'unsupported' || metadata.support === 'notImplemented') {\n        return createUnavailableSupportState(permission);\n      }\n\n      if (metadata.support === 'notRequired') {\n        return createNotRequiredState(permission);\n      }\n\n      const adapter = adapters[permission];\n      if (!adapter) {\n        throw new Error(`No adapter registered for permission: ${permission}`);\n      }\n\n      return adapter.getStatus(permission);\n    },\n\n    async request(permission: Permission): Promise<PermissionState> {\n      const metadata = EXPO_PERMISSION_SUPPORT[permission];\n      if (metadata.support === 'unsupported' || metadata.support === 'notImplemented') {\n        return createUnavailableSupportState(permission);\n      }\n\n      if (metadata.support === 'notRequired') {\n        return createNotRequiredState(permission);\n      }\n\n      const adapter = adapters[permission];\n      if (!adapter) {\n        throw new Error(`No adapter registered for permission: ${permission}`);\n      }\n\n      return adapter.request(permission);\n    },\n  };\n}\n\nfunction createUnavailableSupportState(permission: Permission): PermissionState {\n  return createPermissionState({\n    permission,\n    status: 'unavailable',\n    reason: `Permission ${permission} is not implemented or supported on Expo.`,\n  });\n}\n\nfunction createNotRequiredState(permission: Permission): PermissionState {\n  return createPermissionState({\n    permission,\n    status: 'granted',\n  });\n}\n"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/expo/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAwB,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,2BAA2B,GAAG,sCAAsC,CAAC;AAO3E,MAAM,QAAQ,GAAuD;IACnE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,aAAa;IAClC,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,mBAAmB;IAC9C,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,mBAAmB;IACnD,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,iBAAiB;IAC1C,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,eAAe;IAChD,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,eAAe;IAChD,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,oBAAoB;CACjD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,KAAK,CAAC,SAAS,CAAC,UAAsB;YACpC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;YACrD,IAAI,QAAQ,CAAC,OAAO,KAAK,aAAa,IAAI,QAAQ,CAAC,OAAO,KAAK,gBAAgB,EAAE,CAAC;gBAChF,OAAO,6BAA6B,CAAC,UAAU,CAAC,CAAC;YACnD,CAAC;YAED,IAAI,QAAQ,CAAC,OAAO,KAAK,aAAa,EAAE,CAAC;gBACvC,OAAO,sBAAsB,CAAC,UAAU,CAAC,CAAC;YAC5C,CAAC;YAED,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,yCAAyC,UAAU,EAAE,CAAC,CAAC;YACzE,CAAC;YAED,OAAO,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,UAAsB;YAClC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;YACrD,IAAI,QAAQ,CAAC,OAAO,KAAK,aAAa,IAAI,QAAQ,CAAC,OAAO,KAAK,gBAAgB,EAAE,CAAC;gBAChF,OAAO,6BAA6B,CAAC,UAAU,CAAC,CAAC;YACnD,CAAC;YAED,IAAI,QAAQ,CAAC,OAAO,KAAK,aAAa,EAAE,CAAC;gBACvC,OAAO,sBAAsB,CAAC,UAAU,CAAC,CAAC;YAC5C,CAAC;YAED,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,yCAAyC,UAAU,EAAE,CAAC,CAAC;YACzE,CAAC;YAED,OAAO,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC;QAED,KAAK,CAAC,YAAY;YAChB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;gBAE7C,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;YAC/B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,2BAA2B,EAAE;oBAC3C,KAAK,EAAE,KAAK;iBACb,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,6BAA6B,CAAC,UAAsB;IAC3D,OAAO,qBAAqB,CAAC;QAC3B,UAAU;QACV,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,cAAc,UAAU,2CAA2C;KAC5E,CAAC,CAAC;AACL,CAAC;AAED,SAAS,sBAAsB,CAAC,UAAsB;IACpD,OAAO,qBAAqB,CAAC;QAC3B,UAAU;QACV,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { PermissionClient } from '../client/types';\nimport { Permission } from '../registry/permissions';\nimport { createPermissionState, type PermissionState } from '../state/permissionState';\nimport { cameraAdapter } from './adapters/camera';\nimport { locationAdapter } from './adapters/location';\nimport { mediaLibraryAdapter } from './adapters/mediaLibrary';\nimport { microphoneAdapter } from './adapters/microphone';\nimport { notificationsAdapter } from './adapters/notifications';\nimport { EXPO_PERMISSION_SUPPORT } from './manifest';\n\nconst OPEN_SETTINGS_ERROR_MESSAGE = 'Unable to open application settings.';\n\nexport interface ExpoPermissionAdapter {\n  getStatus(permission: Permission): Promise<PermissionState>;\n  request(permission: Permission): Promise<PermissionState>;\n}\n\nconst adapters: Partial<Record<Permission, ExpoPermissionAdapter>> = {\n  [Permission.Camera]: cameraAdapter,\n  [Permission.MediaLibrary]: mediaLibraryAdapter,\n  [Permission.MediaLibraryWrite]: mediaLibraryAdapter,\n  [Permission.Microphone]: microphoneAdapter,\n  [Permission.LocationForeground]: locationAdapter,\n  [Permission.LocationBackground]: locationAdapter,\n  [Permission.Notifications]: notificationsAdapter,\n};\n\n/***\n * Creates a permission client backed by Expo SDK modules.\n *\n * Denials that Expo cannot request again are normalized to `blocked`. Limited\n * media-library access and provisional or ephemeral iOS notification access\n * are normalized to usable `limited` states, where `granted` remains true.\n * The client requires `expo-linking` for settings recovery and rejects with a\n * stable error when the operating-system settings page cannot be opened.\n *\n * Expo modules are loaded only when a client operation uses them. The package\n * root and Expo manifest metadata remain free of native module imports.\n *\n * @readme\n */\nexport function createPermissionClient(): PermissionClient {\n  return {\n    async getStatus(permission: Permission): Promise<PermissionState> {\n      const metadata = EXPO_PERMISSION_SUPPORT[permission];\n      if (metadata.support === 'unsupported' || metadata.support === 'notImplemented') {\n        return createUnavailableSupportState(permission);\n      }\n\n      if (metadata.support === 'notRequired') {\n        return createNotRequiredState(permission);\n      }\n\n      const adapter = adapters[permission];\n      if (!adapter) {\n        throw new Error(`No adapter registered for permission: ${permission}`);\n      }\n\n      return adapter.getStatus(permission);\n    },\n\n    async request(permission: Permission): Promise<PermissionState> {\n      const metadata = EXPO_PERMISSION_SUPPORT[permission];\n      if (metadata.support === 'unsupported' || metadata.support === 'notImplemented') {\n        return createUnavailableSupportState(permission);\n      }\n\n      if (metadata.support === 'notRequired') {\n        return createNotRequiredState(permission);\n      }\n\n      const adapter = adapters[permission];\n      if (!adapter) {\n        throw new Error(`No adapter registered for permission: ${permission}`);\n      }\n\n      return adapter.request(permission);\n    },\n\n    async openSettings(): Promise<void> {\n      try {\n        const linking = await import('expo-linking');\n\n        await linking.openSettings();\n      } catch (error) {\n        throw new Error(OPEN_SETTINGS_ERROR_MESSAGE, {\n          cause: error,\n        });\n      }\n    },\n  };\n}\n\nfunction createUnavailableSupportState(permission: Permission): PermissionState {\n  return createPermissionState({\n    permission,\n    status: 'unavailable',\n    reason: `Permission ${permission} is not implemented or supported on Expo.`,\n  });\n}\n\nfunction createNotRequiredState(permission: Permission): PermissionState {\n  return createPermissionState({\n    permission,\n    status: 'granted',\n  });\n}\n"]}

package/dist/expo/manifest.d.ts

@@ -5,5 +5,10 @@ export interface ExpoPermissionMetadata {
     readonly requiredPackages: readonly string[];
     readonly configHints: readonly string[];
 }
+/***
+ * Expo packages required by the permission client independently of a specific
+ * permission capability.
+ */
+export declare const EXPO_PERMISSION_CLIENT_REQUIRED_PACKAGES: readonly ["expo-linking"];
 export declare const EXPO_PERMISSION_SUPPORT: Readonly<Record<Permission, ExpoPermissionMetadata>>;
 //# sourceMappingURL=manifest.d.ts.map

package/dist/expo/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/expo/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,aAAa,GACb,SAAS,GACT,gBAAgB,GAChB,aAAa,CAAC;AAElB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAyCxF,CAAC"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/expo/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,aAAa,GACb,SAAS,GACT,gBAAgB,GAChB,aAAa,CAAC;AAElB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED;;;GAGG;AACH,eAAO,MAAM,wCAAwC,2BAA4B,CAAC;AAElF,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAyCxF,CAAC"}

package/dist/expo/manifest.js

@@ -1,4 +1,9 @@
 import { Permission } from '../registry/permissions';
+/***
+ * Expo packages required by the permission client independently of a specific
+ * permission capability.
+ */
+export const EXPO_PERMISSION_CLIENT_REQUIRED_PACKAGES = ['expo-linking'];
 export const EXPO_PERMISSION_SUPPORT = {
     [Permission.Camera]: {
         support: 'supported',

package/dist/expo/manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/expo/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAerD,MAAM,CAAC,MAAM,uBAAuB,GAAyD;IAC3F,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;QACnB,OAAO,EAAE,WAAW;QACpB,gBAAgB,EAAE,CAAC,aAAa,CAAC;QACjC,WAAW,EAAE,CAAC,kBAAkB,CAAC;KAClC;IACD,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;QACvB,OAAO,EAAE,WAAW;QACpB,gBAAgB,EAAE,CAAC,YAAY,CAAC;QAChC,WAAW,EAAE,CAAC,sBAAsB,EAAE,oBAAoB,CAAC;KAC5D;IACD,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;QACzB,OAAO,EAAE,WAAW;QACpB,gBAAgB,EAAE,CAAC,oBAAoB,CAAC;QACxC,WAAW,EAAE,CAAC,wBAAwB,CAAC;KACxC;IACD,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE;QAC9B,OAAO,EAAE,WAAW;QACpB,gBAAgB,EAAE,CAAC,oBAAoB,CAAC;QACxC,WAAW,EAAE,CAAC,wBAAwB,CAAC;KACxC;IACD,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE;QAC/B,OAAO,EAAE,WAAW;QACpB,gBAAgB,EAAE,CAAC,eAAe,CAAC;QACnC,WAAW,EAAE,CAAC,6BAA6B,CAAC;KAC7C;IACD,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE;QAC/B,OAAO,EAAE,WAAW;QACpB,gBAAgB,EAAE,CAAC,eAAe,CAAC;QACnC,WAAW,EAAE,CAAC,sCAAsC,CAAC;KACtD;IACD,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE;QAC1B,OAAO,EAAE,WAAW;QACpB,gBAAgB,EAAE,CAAC,oBAAoB,CAAC;QACxC,WAAW,EAAE,CAAC,yBAAyB,CAAC;KACzC;IACD,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;QACtB,OAAO,EAAE,aAAa;QACtB,gBAAgB,EAAE,EAAE;QACpB,WAAW,EAAE,EAAE;KAChB;CACF,CAAC","sourcesContent":["import { Permission } from '../registry/permissions';\n\nexport type PermissionSupport =\n  | 'supported'\n  | 'notRequired'\n  | 'limited'\n  | 'notImplemented'\n  | 'unsupported';\n\nexport interface ExpoPermissionMetadata {\n  readonly support: PermissionSupport;\n  readonly requiredPackages: readonly string[];\n  readonly configHints: readonly string[];\n}\n\nexport const EXPO_PERMISSION_SUPPORT: Readonly<Record<Permission, ExpoPermissionMetadata>> = {\n  [Permission.Camera]: {\n    support: 'supported',\n    requiredPackages: ['expo-camera'],\n    configHints: ['cameraPermission'],\n  },\n  [Permission.Microphone]: {\n    support: 'supported',\n    requiredPackages: ['expo-audio'],\n    configHints: ['microphonePermission', 'recordAudioAndroid'],\n  },\n  [Permission.MediaLibrary]: {\n    support: 'supported',\n    requiredPackages: ['expo-media-library'],\n    configHints: ['mediaLibraryPermission'],\n  },\n  [Permission.MediaLibraryWrite]: {\n    support: 'supported',\n    requiredPackages: ['expo-media-library'],\n    configHints: ['mediaLibraryPermission'],\n  },\n  [Permission.LocationForeground]: {\n    support: 'supported',\n    requiredPackages: ['expo-location'],\n    configHints: ['locationWhenInUsePermission'],\n  },\n  [Permission.LocationBackground]: {\n    support: 'supported',\n    requiredPackages: ['expo-location'],\n    configHints: ['locationAlwaysAndWhenInUsePermission'],\n  },\n  [Permission.Notifications]: {\n    support: 'supported',\n    requiredPackages: ['expo-notifications'],\n    configHints: ['notificationsPermission'],\n  },\n  [Permission.Clipboard]: {\n    support: 'notRequired',\n    requiredPackages: [],\n    configHints: [],\n  },\n};\n"]}
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/expo/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAerD;;;GAGG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAG,CAAC,cAAc,CAAU,CAAC;AAElF,MAAM,CAAC,MAAM,uBAAuB,GAAyD;IAC3F,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;QACnB,OAAO,EAAE,WAAW;QACpB,gBAAgB,EAAE,CAAC,aAAa,CAAC;QACjC,WAAW,EAAE,CAAC,kBAAkB,CAAC;KAClC;IACD,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;QACvB,OAAO,EAAE,WAAW;QACpB,gBAAgB,EAAE,CAAC,YAAY,CAAC;QAChC,WAAW,EAAE,CAAC,sBAAsB,EAAE,oBAAoB,CAAC;KAC5D;IACD,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;QACzB,OAAO,EAAE,WAAW;QACpB,gBAAgB,EAAE,CAAC,oBAAoB,CAAC;QACxC,WAAW,EAAE,CAAC,wBAAwB,CAAC;KACxC;IACD,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE;QAC9B,OAAO,EAAE,WAAW;QACpB,gBAAgB,EAAE,CAAC,oBAAoB,CAAC;QACxC,WAAW,EAAE,CAAC,wBAAwB,CAAC;KACxC;IACD,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE;QAC/B,OAAO,EAAE,WAAW;QACpB,gBAAgB,EAAE,CAAC,eAAe,CAAC;QACnC,WAAW,EAAE,CAAC,6BAA6B,CAAC;KAC7C;IACD,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE;QAC/B,OAAO,EAAE,WAAW;QACpB,gBAAgB,EAAE,CAAC,eAAe,CAAC;QACnC,WAAW,EAAE,CAAC,sCAAsC,CAAC;KACtD;IACD,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE;QAC1B,OAAO,EAAE,WAAW;QACpB,gBAAgB,EAAE,CAAC,oBAAoB,CAAC;QACxC,WAAW,EAAE,CAAC,yBAAyB,CAAC;KACzC;IACD,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;QACtB,OAAO,EAAE,aAAa;QACtB,gBAAgB,EAAE,EAAE;QACpB,WAAW,EAAE,EAAE;KAChB;CACF,CAAC","sourcesContent":["import { Permission } from '../registry/permissions';\n\nexport type PermissionSupport =\n  | 'supported'\n  | 'notRequired'\n  | 'limited'\n  | 'notImplemented'\n  | 'unsupported';\n\nexport interface ExpoPermissionMetadata {\n  readonly support: PermissionSupport;\n  readonly requiredPackages: readonly string[];\n  readonly configHints: readonly string[];\n}\n\n/***\n * Expo packages required by the permission client independently of a specific\n * permission capability.\n */\nexport const EXPO_PERMISSION_CLIENT_REQUIRED_PACKAGES = ['expo-linking'] as const;\n\nexport const EXPO_PERMISSION_SUPPORT: Readonly<Record<Permission, ExpoPermissionMetadata>> = {\n  [Permission.Camera]: {\n    support: 'supported',\n    requiredPackages: ['expo-camera'],\n    configHints: ['cameraPermission'],\n  },\n  [Permission.Microphone]: {\n    support: 'supported',\n    requiredPackages: ['expo-audio'],\n    configHints: ['microphonePermission', 'recordAudioAndroid'],\n  },\n  [Permission.MediaLibrary]: {\n    support: 'supported',\n    requiredPackages: ['expo-media-library'],\n    configHints: ['mediaLibraryPermission'],\n  },\n  [Permission.MediaLibraryWrite]: {\n    support: 'supported',\n    requiredPackages: ['expo-media-library'],\n    configHints: ['mediaLibraryPermission'],\n  },\n  [Permission.LocationForeground]: {\n    support: 'supported',\n    requiredPackages: ['expo-location'],\n    configHints: ['locationWhenInUsePermission'],\n  },\n  [Permission.LocationBackground]: {\n    support: 'supported',\n    requiredPackages: ['expo-location'],\n    configHints: ['locationAlwaysAndWhenInUsePermission'],\n  },\n  [Permission.Notifications]: {\n    support: 'supported',\n    requiredPackages: ['expo-notifications'],\n    configHints: ['notificationsPermission'],\n  },\n  [Permission.Clipboard]: {\n    support: 'notRequired',\n    requiredPackages: [],\n    configHints: [],\n  },\n};\n"]}

package/dist/expo/permissionResponse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"permissionResponse.d.ts","sourceRoot":"","sources":["../../src/expo/permissionResponse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAEzE,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,sBAAsB,GAC/B,eAAe,CAQjB;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,OAAO,GACb,eAAe,CAMjB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,MAAM,EAClB,cAAc,GAAE,SAAS,MAAM,EAAO,GACrC,oBAAoB,GAAG,SAAS,CAkBlC"}
+{"version":3,"file":"permissionResponse.d.ts","sourceRoot":"","sources":["../../src/expo/permissionResponse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAEzE,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,sBAAsB,GAC/B,eAAe,CAIjB;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,OAAO,GACb,eAAe,CAMjB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,MAAM,EAClB,cAAc,GAAE,SAAS,MAAM,EAAO,GACrC,oBAAoB,GAAG,SAAS,CAkBlC"}

package/dist/expo/permissionResponse.js

@@ -1,11 +1,7 @@
 import { createPermissionState, isPermissionStatus, } from '../state/permissionState';
 export function createExpoPermissionState(permission, response) {
     const status = isPermissionStatus(response.status) ? response.status : 'unknown';
-    return createPermissionState({
-        permission,
-        status,
-        canAskAgain: response.canAskAgain,
-    });
+    return createNormalizedExpoPermissionState(permission, response, status);
 }
 export function createExpoUnavailableState(permission, error) {
     return createPermissionState({
@@ -38,6 +34,17 @@ function getExpoPermissionErrorMessage(error) {
     }
     return 'Expo permission operation failed.';
 }
+function createNormalizedExpoPermissionState(permission, response, status, reason) {
+    const normalizedStatus = status === 'denied' && response.canAskAgain === false ? 'blocked' : status;
+    return createPermissionState({
+        permission,
+        status: normalizedStatus,
+        canAskAgain: response.canAskAgain,
+        reason: normalizedStatus === 'blocked'
+            ? 'Permission is blocked. Open system settings to change it.'
+            : reason,
+    });
+}
 function hasExpoPermissionMethod(value, methodName) {
     return isRecord(value) && typeof value[methodName] === 'function';
 }

package/dist/expo/permissionResponse.js.map

@@ -1 +1 @@
-{"version":3,"file":"permissionResponse.js","sourceRoot":"","sources":["../../src/expo/permissionResponse.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GAEnB,MAAM,0BAA0B,CAAC;AASlC,MAAM,UAAU,yBAAyB,CACvC,UAAsB,EACtB,QAAgC;IAEhC,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjF,OAAO,qBAAqB,CAAC;QAC3B,UAAU;QACV,MAAM;QACN,WAAW,EAAE,QAAQ,CAAC,WAAW;KAClC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,UAAsB,EACtB,KAAc;IAEd,OAAO,qBAAqB,CAAC;QAC3B,UAAU;QACV,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,6BAA6B,CAAC,KAAK,CAAC;KAC7C,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,MAAe,EACf,UAAkB,EAClB,iBAAoC,EAAE;IAEtC,IAAI,uBAAuB,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;QAExC,IAAI,uBAAuB,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,CAAC;YACnD,OAAO,SAAS,CAAC,UAAU,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,6BAA6B,CAAC,KAAc;IACnD,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvD,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,mCAAmC,CAAC;AAC7C,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAAc,EACd,UAAkB;IAElB,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,UAAU,CAAC,KAAK,UAAU,CAAC;AACpE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC","sourcesContent":["import type { Permission } from '../registry/permissions';\nimport {\n  createPermissionState,\n  isPermissionStatus,\n  type PermissionState,\n} from '../state/permissionState';\n\nexport interface ExpoPermissionResponse {\n  readonly status: string;\n  readonly canAskAgain?: boolean;\n}\n\nexport type ExpoPermissionMethod = () => Promise<ExpoPermissionResponse>;\n\nexport function createExpoPermissionState(\n  permission: Permission,\n  response: ExpoPermissionResponse,\n): PermissionState {\n  const status = isPermissionStatus(response.status) ? response.status : 'unknown';\n\n  return createPermissionState({\n    permission,\n    status,\n    canAskAgain: response.canAskAgain,\n  });\n}\n\nexport function createExpoUnavailableState(\n  permission: Permission,\n  error: unknown,\n): PermissionState {\n  return createPermissionState({\n    permission,\n    status: 'unavailable',\n    reason: getExpoPermissionErrorMessage(error),\n  });\n}\n\nexport function findExpoPermissionMethod(\n  source: unknown,\n  methodName: string,\n  containerNames: readonly string[] = [],\n): ExpoPermissionMethod | undefined {\n  if (hasExpoPermissionMethod(source, methodName)) {\n    return source[methodName];\n  }\n\n  if (!isRecord(source)) {\n    return undefined;\n  }\n\n  for (const containerName of containerNames) {\n    const container = source[containerName];\n\n    if (hasExpoPermissionMethod(container, methodName)) {\n      return container[methodName];\n    }\n  }\n\n  return undefined;\n}\n\nfunction getExpoPermissionErrorMessage(error: unknown): string {\n  if (error instanceof Error && error.message.length > 0) {\n    return error.message;\n  }\n\n  if (typeof error === 'string' && error.length > 0) {\n    return error;\n  }\n\n  return 'Expo permission operation failed.';\n}\n\nfunction hasExpoPermissionMethod(\n  value: unknown,\n  methodName: string,\n): value is Record<string, ExpoPermissionMethod> {\n  return isRecord(value) && typeof value[methodName] === 'function';\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n"]}
+{"version":3,"file":"permissionResponse.js","sourceRoot":"","sources":["../../src/expo/permissionResponse.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GAGnB,MAAM,0BAA0B,CAAC;AASlC,MAAM,UAAU,yBAAyB,CACvC,UAAsB,EACtB,QAAgC;IAEhC,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjF,OAAO,mCAAmC,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,UAAsB,EACtB,KAAc;IAEd,OAAO,qBAAqB,CAAC;QAC3B,UAAU;QACV,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,6BAA6B,CAAC,KAAK,CAAC;KAC7C,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,MAAe,EACf,UAAkB,EAClB,iBAAoC,EAAE;IAEtC,IAAI,uBAAuB,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;QAExC,IAAI,uBAAuB,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,CAAC;YACnD,OAAO,SAAS,CAAC,UAAU,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,6BAA6B,CAAC,KAAc;IACnD,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvD,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,mCAAmC,CAAC;AAC7C,CAAC;AAED,SAAS,mCAAmC,CAC1C,UAAsB,EACtB,QAAgC,EAChC,MAAwB,EACxB,MAAe;IAEf,MAAM,gBAAgB,GACpB,MAAM,KAAK,QAAQ,IAAI,QAAQ,CAAC,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;IAE7E,OAAO,qBAAqB,CAAC;QAC3B,UAAU;QACV,MAAM,EAAE,gBAAgB;QACxB,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,MAAM,EACJ,gBAAgB,KAAK,SAAS;YAC5B,CAAC,CAAC,2DAA2D;YAC7D,CAAC,CAAC,MAAM;KACb,CAAC,CAAC;AACL,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAAc,EACd,UAAkB;IAElB,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,UAAU,CAAC,KAAK,UAAU,CAAC;AACpE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC","sourcesContent":["import type { Permission } from '../registry/permissions';\nimport {\n  createPermissionState,\n  isPermissionStatus,\n  type PermissionState,\n  type PermissionStatus,\n} from '../state/permissionState';\n\nexport interface ExpoPermissionResponse {\n  readonly status: string;\n  readonly canAskAgain?: boolean;\n}\n\nexport type ExpoPermissionMethod = () => Promise<ExpoPermissionResponse>;\n\nexport function createExpoPermissionState(\n  permission: Permission,\n  response: ExpoPermissionResponse,\n): PermissionState {\n  const status = isPermissionStatus(response.status) ? response.status : 'unknown';\n\n  return createNormalizedExpoPermissionState(permission, response, status);\n}\n\nexport function createExpoUnavailableState(\n  permission: Permission,\n  error: unknown,\n): PermissionState {\n  return createPermissionState({\n    permission,\n    status: 'unavailable',\n    reason: getExpoPermissionErrorMessage(error),\n  });\n}\n\nexport function findExpoPermissionMethod(\n  source: unknown,\n  methodName: string,\n  containerNames: readonly string[] = [],\n): ExpoPermissionMethod | undefined {\n  if (hasExpoPermissionMethod(source, methodName)) {\n    return source[methodName];\n  }\n\n  if (!isRecord(source)) {\n    return undefined;\n  }\n\n  for (const containerName of containerNames) {\n    const container = source[containerName];\n\n    if (hasExpoPermissionMethod(container, methodName)) {\n      return container[methodName];\n    }\n  }\n\n  return undefined;\n}\n\nfunction getExpoPermissionErrorMessage(error: unknown): string {\n  if (error instanceof Error && error.message.length > 0) {\n    return error.message;\n  }\n\n  if (typeof error === 'string' && error.length > 0) {\n    return error;\n  }\n\n  return 'Expo permission operation failed.';\n}\n\nfunction createNormalizedExpoPermissionState(\n  permission: Permission,\n  response: ExpoPermissionResponse,\n  status: PermissionStatus,\n  reason?: string,\n): PermissionState {\n  const normalizedStatus =\n    status === 'denied' && response.canAskAgain === false ? 'blocked' : status;\n\n  return createPermissionState({\n    permission,\n    status: normalizedStatus,\n    canAskAgain: response.canAskAgain,\n    reason:\n      normalizedStatus === 'blocked'\n        ? 'Permission is blocked. Open system settings to change it.'\n        : reason,\n  });\n}\n\nfunction hasExpoPermissionMethod(\n  value: unknown,\n  methodName: string,\n): value is Record<string, ExpoPermissionMethod> {\n  return isRecord(value) && typeof value[methodName] === 'function';\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n"]}

package/dist/state/permissionState.d.ts

@@ -34,6 +34,8 @@ export interface CreatePermissionStateInput {
 export declare function isPermissionStatus(value: string): value is PermissionStatus;
 /***
  * Creates a normalized state and derives the `granted` convenience flag.
+ * Limited access is usable partial authorization, so both `granted` and
+ * `limited` states set `granted` to true.
  */
 export declare function createPermissionState(input: CreatePermissionStateInput): PermissionState;
 /***

package/dist/state/permissionState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"permissionState.d.ts","sourceRoot":"","sources":["../../src/state/permissionState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,SAAS,GACT,QAAQ,GACR,SAAS,GACT,SAAS,GACT,aAAa,CAAC;AAElB;;GAEG;AACH,eAAO,MAAM,mBAAmB,gFAOgB,CAAC;AAIjD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB,CAE3E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,eAAe,CASxF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,eAAe,GACrB,eAAe,CAQjB"}
+{"version":3,"file":"permissionState.d.ts","sourceRoot":"","sources":["../../src/state/permissionState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,SAAS,GACT,QAAQ,GACR,SAAS,GACT,SAAS,GACT,aAAa,CAAC;AAElB;;GAEG;AACH,eAAO,MAAM,mBAAmB,gFAOgB,CAAC;AAIjD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,eAAe,CASxF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,eAAe,GACrB,eAAe,CAQjB"}

package/dist/state/permissionState.js

@@ -18,13 +18,15 @@ export function isPermissionStatus(value) {
 }
 /***
  * Creates a normalized state and derives the `granted` convenience flag.
+ * Limited access is usable partial authorization, so both `granted` and
+ * `limited` states set `granted` to true.
  */
 export function createPermissionState(input) {
     return {
         permission: input.permission,
         status: input.status,
         canAskAgain: input.canAskAgain,
-        granted: input.status === 'granted',
+        granted: input.status === 'granted' || input.status === 'limited',
         requestedAt: input.requestedAt,
         reason: input.reason,
     };

package/dist/state/permissionState.js.map

@@ -1 +1 @@
-{"version":3,"file":"permissionState.js","sourceRoot":"","sources":["../../src/state/permissionState.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,SAAS;IACT,SAAS;IACT,QAAQ;IACR,SAAS;IACT,SAAS;IACT,aAAa;CACiC,CAAC;AAEjD,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAS,mBAAmB,CAAC,CAAC;AAsBnE;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAiC;IACrE,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO,EAAE,KAAK,CAAC,MAAM,KAAK,SAAS;QACnC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,UAAsB,EACtB,KAAsB;IAEtB,OAAO,qBAAqB,CAAC;QAC3B,UAAU;QACV,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Permission } from '../registry/permissions';\n\n/***\n * Normalized permission statuses shared by adapters and UI code.\n *\n * Denial is normal control flow. Unexpected adapter failures may still throw,\n * but user denial should be represented as a permission state.\n */\nexport type PermissionStatus =\n  | 'unknown'\n  | 'granted'\n  | 'denied'\n  | 'blocked'\n  | 'limited'\n  | 'unavailable';\n\n/***\n * Stable ordered list of normalized statuses.\n */\nexport const PERMISSION_STATUSES = [\n  'unknown',\n  'granted',\n  'denied',\n  'blocked',\n  'limited',\n  'unavailable',\n] as const satisfies readonly PermissionStatus[];\n\nconst PERMISSION_STATUS_SET = new Set<string>(PERMISSION_STATUSES);\n\n/***\n * Normalized result returned by permission clients and managers.\n */\nexport interface PermissionState {\n  readonly permission: Permission;\n  readonly status: PermissionStatus;\n  readonly canAskAgain?: boolean;\n  readonly granted: boolean;\n  readonly requestedAt?: Date;\n  readonly reason?: string;\n}\n\nexport interface CreatePermissionStateInput {\n  readonly permission: Permission;\n  readonly status: PermissionStatus;\n  readonly canAskAgain?: boolean;\n  readonly requestedAt?: Date;\n  readonly reason?: string;\n}\n\n/***\n * Returns true when a string is one of the normalized statuses.\n */\nexport function isPermissionStatus(value: string): value is PermissionStatus {\n  return PERMISSION_STATUS_SET.has(value);\n}\n\n/***\n * Creates a normalized state and derives the `granted` convenience flag.\n */\nexport function createPermissionState(input: CreatePermissionStateInput): PermissionState {\n  return {\n    permission: input.permission,\n    status: input.status,\n    canAskAgain: input.canAskAgain,\n    granted: input.status === 'granted',\n    requestedAt: input.requestedAt,\n    reason: input.reason,\n  };\n}\n\n/***\n * Normalizes an adapter result to the requested permission and status shape.\n */\nexport function normalizePermissionState(\n  permission: Permission,\n  state: PermissionState,\n): PermissionState {\n  return createPermissionState({\n    permission,\n    status: state.status,\n    canAskAgain: state.canAskAgain,\n    requestedAt: state.requestedAt,\n    reason: state.reason,\n  });\n}\n"]}
+{"version":3,"file":"permissionState.js","sourceRoot":"","sources":["../../src/state/permissionState.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,SAAS;IACT,SAAS;IACT,QAAQ;IACR,SAAS;IACT,SAAS;IACT,aAAa;CACiC,CAAC;AAEjD,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAS,mBAAmB,CAAC,CAAC;AAsBnE;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAiC;IACrE,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO,EAAE,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QACjE,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,UAAsB,EACtB,KAAsB;IAEtB,OAAO,qBAAqB,CAAC;QAC3B,UAAU;QACV,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Permission } from '../registry/permissions';\n\n/***\n * Normalized permission statuses shared by adapters and UI code.\n *\n * Denial is normal control flow. Unexpected adapter failures may still throw,\n * but user denial should be represented as a permission state.\n */\nexport type PermissionStatus =\n  | 'unknown'\n  | 'granted'\n  | 'denied'\n  | 'blocked'\n  | 'limited'\n  | 'unavailable';\n\n/***\n * Stable ordered list of normalized statuses.\n */\nexport const PERMISSION_STATUSES = [\n  'unknown',\n  'granted',\n  'denied',\n  'blocked',\n  'limited',\n  'unavailable',\n] as const satisfies readonly PermissionStatus[];\n\nconst PERMISSION_STATUS_SET = new Set<string>(PERMISSION_STATUSES);\n\n/***\n * Normalized result returned by permission clients and managers.\n */\nexport interface PermissionState {\n  readonly permission: Permission;\n  readonly status: PermissionStatus;\n  readonly canAskAgain?: boolean;\n  readonly granted: boolean;\n  readonly requestedAt?: Date;\n  readonly reason?: string;\n}\n\nexport interface CreatePermissionStateInput {\n  readonly permission: Permission;\n  readonly status: PermissionStatus;\n  readonly canAskAgain?: boolean;\n  readonly requestedAt?: Date;\n  readonly reason?: string;\n}\n\n/***\n * Returns true when a string is one of the normalized statuses.\n */\nexport function isPermissionStatus(value: string): value is PermissionStatus {\n  return PERMISSION_STATUS_SET.has(value);\n}\n\n/***\n * Creates a normalized state and derives the `granted` convenience flag.\n * Limited access is usable partial authorization, so both `granted` and\n * `limited` states set `granted` to true.\n */\nexport function createPermissionState(input: CreatePermissionStateInput): PermissionState {\n  return {\n    permission: input.permission,\n    status: input.status,\n    canAskAgain: input.canAskAgain,\n    granted: input.status === 'granted' || input.status === 'limited',\n    requestedAt: input.requestedAt,\n    reason: input.reason,\n  };\n}\n\n/***\n * Normalizes an adapter result to the requested permission and status shape.\n */\nexport function normalizePermissionState(\n  permission: Permission,\n  state: PermissionState,\n): PermissionState {\n  return createPermissionState({\n    permission,\n    status: state.status,\n    canAskAgain: state.canAskAgain,\n    requestedAt: state.requestedAt,\n    reason: state.reason,\n  });\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/permissions",
   "type": "module",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Cross-platform permission registry and runtime helpers for Expo, React Native, and React Native Web apps, with unified request/check APIs for camera, media, location, notifications, microphone, and other web/native capabilities.",
   "homepage": "https://github.com/ankhorage/permissions#readme",
   "bugs": {
@@ -39,8 +39,13 @@
   },
   "ankh": {
     "category": "permissions",
-    "provider": null,
-    "capabilities": []
+    "provider": "./dist/cli/index.js",
+    "capabilities": [
+      "permissions.inspect",
+      "permissions.check",
+      "permissions.request",
+      "permissions.manifest"
+    ]
   },
   "files": [
     "dist",
@@ -58,6 +63,11 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./cli": {
+      "types": "./dist/cli/index.d.ts",
+      "import": "./dist/cli/index.js",
+      "default": "./dist/cli/index.js"
+    },
     "./react": {
       "react-native": "./dist/react/index.js",
       "browser": "./dist/react/index.js",

package/src/cli/index.ts

@@ -0,0 +1 @@
+export { default } from '../ankh.provider.js';

package/src/expo/adapters/mediaLibrary.ts

@@ -1,8 +1,16 @@
 import type { Permission } from '../../registry/permissions';
 import { Permission as KnownPermission } from '../../registry/permissions';
-import type { PermissionState } from '../../state/permissionState';
+import { createPermissionState, type PermissionState } from '../../state/permissionState';
 import type { ExpoPermissionAdapter } from '../client';
-import { createExpoPermissionState, createExpoUnavailableState } from '../permissionResponse';
+import {
+  createExpoPermissionState,
+  createExpoUnavailableState,
+  type ExpoPermissionResponse,
+} from '../permissionResponse';
+
+interface ExpoMediaLibraryPermissionResponse extends ExpoPermissionResponse {
+  readonly accessPrivileges?: 'all' | 'limited' | 'none';
+}
 
 export const mediaLibraryAdapter: ExpoPermissionAdapter = {
   async getStatus(permission: Permission): Promise<PermissionState> {
@@ -10,7 +18,7 @@ export const mediaLibraryAdapter: ExpoPermissionAdapter = {
       const mod = await import('expo-media-library');
       const result = await mod.getPermissionsAsync(isWriteOnlyPermission(permission));
 
-      return createExpoPermissionState(permission, result);
+      return createMediaLibraryPermissionState(permission, result);
     } catch (error) {
       return createExpoUnavailableState(permission, error);
     }
@@ -21,13 +29,29 @@ export const mediaLibraryAdapter: ExpoPermissionAdapter = {
       const mod = await import('expo-media-library');
       const result = await mod.requestPermissionsAsync(isWriteOnlyPermission(permission));
 
-      return createExpoPermissionState(permission, result);
+      return createMediaLibraryPermissionState(permission, result);
     } catch (error) {
       return createExpoUnavailableState(permission, error);
     }
   },
 };
 
+function createMediaLibraryPermissionState(
+  permission: Permission,
+  response: ExpoMediaLibraryPermissionResponse,
+): PermissionState {
+  if (response.accessPrivileges !== 'limited') {
+    return createExpoPermissionState(permission, response);
+  }
+
+  return createPermissionState({
+    permission,
+    status: 'limited',
+    canAskAgain: response.canAskAgain,
+    reason: 'Media library access is limited to user-selected assets.',
+  });
+}
+
 function isWriteOnlyPermission(permission: Permission): boolean {
   return permission === KnownPermission.MediaLibraryWrite;
 }

package/src/expo/adapters/notifications.ts

@@ -1,7 +1,17 @@
 import type { Permission } from '../../registry/permissions';
-import type { PermissionState } from '../../state/permissionState';
+import { createPermissionState, type PermissionState } from '../../state/permissionState';
 import type { ExpoPermissionAdapter } from '../client';
-import { createExpoPermissionState, createExpoUnavailableState } from '../permissionResponse';
+import {
+  createExpoPermissionState,
+  createExpoUnavailableState,
+  type ExpoPermissionResponse,
+} from '../permissionResponse';
+
+interface ExpoNotificationPermissionResponse extends ExpoPermissionResponse {
+  readonly ios?: {
+    readonly status?: number;
+  };
+}
 
 export const notificationsAdapter: ExpoPermissionAdapter = {
   async getStatus(permission: Permission): Promise<PermissionState> {
@@ -9,7 +19,7 @@ export const notificationsAdapter: ExpoPermissionAdapter = {
       const mod = await import('expo-notifications');
       const result = await mod.getPermissionsAsync();
 
-      return createExpoPermissionState(permission, result);
+      return createNotificationPermissionState(permission, result);
     } catch (error) {
       return createExpoUnavailableState(permission, error);
     }
@@ -20,9 +30,68 @@ export const notificationsAdapter: ExpoPermissionAdapter = {
       const mod = await import('expo-notifications');
       const result = await mod.requestPermissionsAsync();
 
-      return createExpoPermissionState(permission, result);
+      return createNotificationPermissionState(permission, result);
     } catch (error) {
       return createExpoUnavailableState(permission, error);
     }
   },
 };
+
+function createNotificationPermissionState(
+  permission: Permission,
+  response: ExpoNotificationPermissionResponse,
+): PermissionState {
+  switch (response.ios?.status) {
+    case 0:
+      return createNotificationState(
+        permission,
+        response,
+        'unknown',
+        'iOS notification authorization has not been determined.',
+      );
+    case 1:
+      return createNotificationState(
+        permission,
+        response,
+        'denied',
+        'iOS notification authorization is denied.',
+      );
+    case 2:
+      return createNotificationState(permission, response, 'granted');
+    case 3:
+      return createNotificationState(
+        permission,
+        response,
+        'limited',
+        'iOS notification authorization is provisional.',
+      );
+    case 4:
+      return createNotificationState(
+        permission,
+        response,
+        'limited',
+        'iOS notification authorization is ephemeral.',
+      );
+    default:
+      return createExpoPermissionState(permission, response);
+  }
+}
+
+function createNotificationState(
+  permission: Permission,
+  response: ExpoNotificationPermissionResponse,
+  status: PermissionState['status'],
+  reason?: string,
+): PermissionState {
+  const state = createExpoPermissionState(permission, {
+    status,
+    canAskAgain: response.canAskAgain,
+  });
+
+  return createPermissionState({
+    permission,
+    status: state.status,
+    canAskAgain: state.canAskAgain,
+    reason: state.reason ?? reason,
+  });
+}

package/src/expo/client.test.ts

@@ -6,6 +6,10 @@ import { createPermissionClient } from './client';
 interface MockPermissionResponse {
   readonly status: string;
   readonly canAskAgain?: boolean;
+  readonly accessPrivileges?: 'all' | 'limited' | 'none';
+  readonly ios?: {
+    readonly status?: number;
+  };
 }
 
 type CameraMockMode = 'topLevel' | 'cameraNamespace' | 'missingExports';
@@ -56,6 +60,11 @@ const notificationsMock = {
   requestError: undefined as string | undefined,
 };
 
+const linkingMock = {
+  calls: 0,
+  error: undefined as Error | undefined,
+};
+
 void mock.module('expo-camera', () => ({
   get getCameraPermissionsAsync() {
     if (cameraMock.mode !== 'topLevel') {
@@ -195,6 +204,18 @@ void mock.module('expo-notifications', () => ({
   },
 }));
 
+void mock.module('expo-linking', () => ({
+  openSettings: () => {
+    linkingMock.calls += 1;
+
+    if (linkingMock.error !== undefined) {
+      throw linkingMock.error;
+    }
+
+    return Promise.resolve();
+  },
+}));
+
 describe('createPermissionClient', () => {
   beforeEach(() => {
     resetExpoMocks();
@@ -249,9 +270,10 @@ describe('createPermissionClient', () => {
 
     expect(await client.getStatus(Permission.Camera)).toMatchObject({
       permission: Permission.Camera,
-      status: 'denied',
+      status: 'blocked',
       granted: false,
       canAskAgain: false,
+      reason: 'Permission is blocked. Open system settings to change it.',
     });
     expect(await client.request(Permission.Camera)).toMatchObject({
       permission: Permission.Camera,
@@ -269,9 +291,10 @@ describe('createPermissionClient', () => {
 
     expect(await client.getStatus(Permission.Microphone)).toMatchObject({
       permission: Permission.Microphone,
-      status: 'denied',
+      status: 'blocked',
       granted: false,
       canAskAgain: false,
+      reason: 'Permission is blocked. Open system settings to change it.',
     });
     expect(await client.request(Permission.Microphone)).toMatchObject({
       permission: Permission.Microphone,
@@ -295,18 +318,157 @@ describe('createPermissionClient', () => {
     });
   });
 
-  test('preserves denied request responses', async () => {
+  test('normalizes non-requestable denials to blocked for getStatus and request', async () => {
+    notificationsMock.getResponse = permissionResponse('denied', false);
     notificationsMock.requestResponse = permissionResponse('denied', false);
 
     const client = createPermissionClient();
-    const state = await client.request(Permission.Notifications);
 
-    expect(state).toMatchObject({
-      permission: Permission.Notifications,
-      status: 'denied',
-      granted: false,
+    for (const state of [
+      await client.getStatus(Permission.Notifications),
+      await client.request(Permission.Notifications),
+    ]) {
+      expect(state).toMatchObject({
+        permission: Permission.Notifications,
+        status: 'blocked',
+        granted: false,
+        canAskAgain: false,
+        reason: 'Permission is blocked. Open system settings to change it.',
+      });
+    }
+  });
+
+  test('normalizes limited media-library access as usable partial authorization', async () => {
+    mediaLibraryMock.getResponse = {
+      status: 'granted',
       canAskAgain: false,
-    });
+      accessPrivileges: 'limited',
+    };
+    mediaLibraryMock.requestResponse = {
+      status: 'granted',
+      canAskAgain: false,
+      accessPrivileges: 'limited',
+    };
+
+    const client = createPermissionClient();
+
+    for (const state of [
+      await client.getStatus(Permission.MediaLibrary),
+      await client.request(Permission.MediaLibrary),
+    ]) {
+      expect(state).toMatchObject({
+        permission: Permission.MediaLibrary,
+        status: 'limited',
+        granted: true,
+        canAskAgain: false,
+        reason: 'Media library access is limited to user-selected assets.',
+      });
+    }
+  });
+
+  test('uses granular iOS notification authorization for getStatus and request', async () => {
+    const cases = [
+      {
+        iosStatus: 0,
+        canAskAgain: true,
+        expectedStatus: 'unknown',
+        expectedGranted: false,
+        expectedReason: 'iOS notification authorization has not been determined.',
+      },
+      {
+        iosStatus: 1,
+        canAskAgain: true,
+        expectedStatus: 'denied',
+        expectedGranted: false,
+        expectedReason: 'iOS notification authorization is denied.',
+      },
+      {
+        iosStatus: 1,
+        canAskAgain: false,
+        expectedStatus: 'blocked',
+        expectedGranted: false,
+        expectedReason: 'Permission is blocked. Open system settings to change it.',
+      },
+      {
+        iosStatus: 2,
+        canAskAgain: false,
+        expectedStatus: 'granted',
+        expectedGranted: true,
+        expectedReason: undefined,
+      },
+      {
+        iosStatus: 3,
+        canAskAgain: false,
+        expectedStatus: 'limited',
+        expectedGranted: true,
+        expectedReason: 'iOS notification authorization is provisional.',
+      },
+      {
+        iosStatus: 4,
+        canAskAgain: false,
+        expectedStatus: 'limited',
+        expectedGranted: true,
+        expectedReason: 'iOS notification authorization is ephemeral.',
+      },
+    ] as const;
+
+    const client = createPermissionClient();
+
+    for (const testCase of cases) {
+      const response: MockPermissionResponse = {
+        status: testCase.iosStatus === 2 ? 'denied' : 'granted',
+        canAskAgain: testCase.canAskAgain,
+        ios: { status: testCase.iosStatus },
+      };
+      notificationsMock.getResponse = response;
+      notificationsMock.requestResponse = response;
+
+      for (const state of [
+        await client.getStatus(Permission.Notifications),
+        await client.request(Permission.Notifications),
+      ]) {
+        expect(state).toMatchObject({
+          permission: Permission.Notifications,
+          status: testCase.expectedStatus,
+          granted: testCase.expectedGranted,
+          canAskAgain: testCase.canAskAgain,
+          reason: testCase.expectedReason,
+        });
+      }
+    }
+  });
+
+  test('opens native application settings through Expo Linking', async () => {
+    const client = createPermissionClient();
+
+    if (client.openSettings === undefined) {
+      throw new Error('Expo permission client must expose openSettings.');
+    }
+
+    await client.openSettings();
+
+    expect(linkingMock.calls).toBe(1);
+  });
+
+  test('rejects with a stable error and preserves the native failure cause', async () => {
+    const cause = new Error('native settings unavailable');
+    linkingMock.error = cause;
+    const client = createPermissionClient();
+    const error = await captureOpenSettingsErrorAsync(client);
+
+    expect(error.message).toBe('Unable to open application settings.');
+    expect(error.cause).toBe(cause);
+  });
+
+  test('uses the same stable error for Expo Linking on Web', async () => {
+    const cause = new Error('openSettings is unavailable on web');
+    cause.name = 'UnavailabilityError';
+    linkingMock.error = cause;
+    const client = createPermissionClient();
+    const error = await captureOpenSettingsErrorAsync(client);
+
+    expect(error.message).toBe('Unable to open application settings.');
+    expect(error.cause).toBe(cause);
   });
 
   test('returns unavailable when a camera permission call fails at runtime', async () => {
@@ -338,6 +500,26 @@ describe('createPermissionClient', () => {
   });
 });
 
+async function captureOpenSettingsErrorAsync(
+  client: ReturnType<typeof createPermissionClient>,
+): Promise<Error> {
+  if (client.openSettings === undefined) {
+    throw new Error('Expo permission client must expose openSettings.');
+  }
+
+  try {
+    await client.openSettings();
+  } catch (error) {
+    if (error instanceof Error) {
+      return error;
+    }
+
+    throw new Error('Opening settings must reject with an Error instance.', { cause: error });
+  }
+
+  throw new Error('Opening settings must reject.');
+}
+
 function resetExpoMocks(): void {
   cameraMock.mode = 'topLevel';
   cameraMock.getResponse = permissionResponse('granted');
@@ -369,4 +551,7 @@ function resetExpoMocks(): void {
   notificationsMock.requestResponse = permissionResponse('granted');
   notificationsMock.getError = undefined;
   notificationsMock.requestError = undefined;
+
+  linkingMock.calls = 0;
+  linkingMock.error = undefined;
 }

package/src/expo/client.ts

@@ -8,6 +8,8 @@ import { microphoneAdapter } from './adapters/microphone';
 import { notificationsAdapter } from './adapters/notifications';
 import { EXPO_PERMISSION_SUPPORT } from './manifest';
 
+const OPEN_SETTINGS_ERROR_MESSAGE = 'Unable to open application settings.';
+
 export interface ExpoPermissionAdapter {
   getStatus(permission: Permission): Promise<PermissionState>;
   request(permission: Permission): Promise<PermissionState>;
@@ -23,6 +25,20 @@ const adapters: Partial<Record<Permission, ExpoPermissionAdapter>> = {
   [Permission.Notifications]: notificationsAdapter,
 };
 
+/***
+ * Creates a permission client backed by Expo SDK modules.
+ *
+ * Denials that Expo cannot request again are normalized to `blocked`. Limited
+ * media-library access and provisional or ephemeral iOS notification access
+ * are normalized to usable `limited` states, where `granted` remains true.
+ * The client requires `expo-linking` for settings recovery and rejects with a
+ * stable error when the operating-system settings page cannot be opened.
+ *
+ * Expo modules are loaded only when a client operation uses them. The package
+ * root and Expo manifest metadata remain free of native module imports.
+ *
+ * @readme
+ */
 export function createPermissionClient(): PermissionClient {
   return {
     async getStatus(permission: Permission): Promise<PermissionState> {
@@ -60,6 +76,18 @@ export function createPermissionClient(): PermissionClient {
 
       return adapter.request(permission);
     },
+
+    async openSettings(): Promise<void> {
+      try {
+        const linking = await import('expo-linking');
+
+        await linking.openSettings();
+      } catch (error) {
+        throw new Error(OPEN_SETTINGS_ERROR_MESSAGE, {
+          cause: error,
+        });
+      }
+    },
   };
 }
 

package/src/expo/manifest.test.ts

@@ -3,7 +3,7 @@ import { readFileSync } from 'node:fs';
 import { describe, expect, test } from 'bun:test';
 
 import { Permission, PERMISSIONS } from '../registry/permissions';
-import { EXPO_PERMISSION_SUPPORT } from './manifest';
+import { EXPO_PERMISSION_CLIENT_REQUIRED_PACKAGES, EXPO_PERMISSION_SUPPORT } from './manifest';
 
 describe('EXPO_PERMISSION_SUPPORT', () => {
   test('defines metadata for every known permission', () => {
@@ -17,6 +17,10 @@ describe('EXPO_PERMISSION_SUPPORT', () => {
     expect(source).not.toContain('await import(');
   });
 
+  test('projects client-level settings recovery dependencies', () => {
+    expect(EXPO_PERMISSION_CLIENT_REQUIRED_PACKAGES).toEqual(['expo-linking']);
+  });
+
   test('includes package and config hints for camera, microphone, and location permissions', () => {
     expect(EXPO_PERMISSION_SUPPORT[Permission.Camera]).toEqual({
       support: 'supported',

package/src/expo/manifest.ts

@@ -13,6 +13,12 @@ export interface ExpoPermissionMetadata {
   readonly configHints: readonly string[];
 }
 
+/***
+ * Expo packages required by the permission client independently of a specific
+ * permission capability.
+ */
+export const EXPO_PERMISSION_CLIENT_REQUIRED_PACKAGES = ['expo-linking'] as const;
+
 export const EXPO_PERMISSION_SUPPORT: Readonly<Record<Permission, ExpoPermissionMetadata>> = {
   [Permission.Camera]: {
     support: 'supported',

package/src/expo/modules.d.ts

@@ -3,6 +3,20 @@ interface ExpoPermissionResult {
   canAskAgain?: boolean;
 }
 
+interface ExpoMediaLibraryPermissionResult extends ExpoPermissionResult {
+  accessPrivileges?: 'all' | 'limited' | 'none';
+}
+
+interface ExpoNotificationPermissionResult extends ExpoPermissionResult {
+  ios?: {
+    status?: number;
+  };
+}
+
+declare module 'expo-linking' {
+  export function openSettings(): Promise<void>;
+}
+
 declare module 'expo-camera' {
   export function getCameraPermissionsAsync(): Promise<ExpoPermissionResult>;
   export function requestCameraPermissionsAsync(): Promise<ExpoPermissionResult>;
@@ -27,11 +41,11 @@ declare module 'expo-media-library' {
   export function getPermissionsAsync(
     writeOnly?: boolean,
     granularPermissions?: readonly string[],
-  ): Promise<ExpoPermissionResult>;
+  ): Promise<ExpoMediaLibraryPermissionResult>;
   export function requestPermissionsAsync(
     writeOnly?: boolean,
     granularPermissions?: readonly string[],
-  ): Promise<ExpoPermissionResult>;
+  ): Promise<ExpoMediaLibraryPermissionResult>;
 }
 
 declare module 'expo-audio' {
@@ -48,6 +62,6 @@ declare module 'expo-audio' {
 }
 
 declare module 'expo-notifications' {
-  export function getPermissionsAsync(): Promise<ExpoPermissionResult>;
-  export function requestPermissionsAsync(): Promise<ExpoPermissionResult>;
+  export function getPermissionsAsync(): Promise<ExpoNotificationPermissionResult>;
+  export function requestPermissionsAsync(): Promise<ExpoNotificationPermissionResult>;
 }

package/src/expo/permissionResponse.ts

@@ -3,6 +3,7 @@ import {
   createPermissionState,
   isPermissionStatus,
   type PermissionState,
+  type PermissionStatus,
 } from '../state/permissionState';
 
 export interface ExpoPermissionResponse {
@@ -18,11 +19,7 @@ export function createExpoPermissionState(
 ): PermissionState {
   const status = isPermissionStatus(response.status) ? response.status : 'unknown';
 
-  return createPermissionState({
-    permission,
-    status,
-    canAskAgain: response.canAskAgain,
-  });
+  return createNormalizedExpoPermissionState(permission, response, status);
 }
 
 export function createExpoUnavailableState(
@@ -72,6 +69,26 @@ function getExpoPermissionErrorMessage(error: unknown): string {
   return 'Expo permission operation failed.';
 }
 
+function createNormalizedExpoPermissionState(
+  permission: Permission,
+  response: ExpoPermissionResponse,
+  status: PermissionStatus,
+  reason?: string,
+): PermissionState {
+  const normalizedStatus =
+    status === 'denied' && response.canAskAgain === false ? 'blocked' : status;
+
+  return createPermissionState({
+    permission,
+    status: normalizedStatus,
+    canAskAgain: response.canAskAgain,
+    reason:
+      normalizedStatus === 'blocked'
+        ? 'Permission is blocked. Open system settings to change it.'
+        : reason,
+  });
+}
+
 function hasExpoPermissionMethod(
   value: unknown,
   methodName: string,

package/src/state/permissionState.test.ts

@@ -25,6 +25,13 @@ describe('permission state', () => {
       }).granted,
     ).toBe(true);
 
+    expect(
+      createPermissionState({
+        permission: Permission.MediaLibrary,
+        status: 'limited',
+      }).granted,
+    ).toBe(true);
+
     expect(
       createPermissionState({
         permission: Permission.Camera,
@@ -45,7 +52,7 @@ describe('permission state', () => {
     expect(state).toEqual({
       permission: Permission.Camera,
       status: 'limited',
-      granted: false,
+      granted: true,
       canAskAgain: true,
       requestedAt: undefined,
       reason: 'library-limited',

package/src/state/permissionState.ts

@@ -57,13 +57,15 @@ export function isPermissionStatus(value: string): value is PermissionStatus {
 
 /***
  * Creates a normalized state and derives the `granted` convenience flag.
+ * Limited access is usable partial authorization, so both `granted` and
+ * `limited` states set `granted` to true.
  */
 export function createPermissionState(input: CreatePermissionStateInput): PermissionState {
   return {
     permission: input.permission,
     status: input.status,
     canAskAgain: input.canAskAgain,
-    granted: input.status === 'granted',
+    granted: input.status === 'granted' || input.status === 'limited',
     requestedAt: input.requestedAt,
     reason: input.reason,
   };