@ankhorage/permissions 0.2.2 → 0.2.4

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @ankhorage/permissions
 
+## 0.2.4
+
+### Patch Changes
+
+- f4b561b: Adopt the current Devtools policy and keep permission clients compatible with strict React and security linting.
+
+## 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.3](././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.
 
@@ -132,11 +132,35 @@ Fake clients make permission flows testable without native devices, browser
 prompts, simulators, or network access.
 
 Module: `src/testing/index.ts`
-Source: `src/testing/index.ts:55:1`
+Source: `src/testing/index.ts:61:1`
 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>
 
@@ -168,7 +192,7 @@ Unsupported web APIs resolve to `status: 'unavailable'`. The adapter does not
 import DOM types and does not assume it is running in a browser.
 
 Module: `src/web/index.ts`
-Source: `src/web/index.ts:78:1`
+Source: `src/web/index.ts:80:1`
 Related symbols: `PermissionClient`, `WebPermissionClientOptions`
 
 </details>

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,47 +6,76 @@ import { mediaLibraryAdapter } from './adapters/mediaLibrary';
 import { microphoneAdapter } from './adapters/microphone';
 import { notificationsAdapter } from './adapters/notifications';
 import { EXPO_PERMISSION_SUPPORT } from './manifest';
-const adapters = {
-    [Permission.Camera]: cameraAdapter,
-    [Permission.MediaLibrary]: mediaLibraryAdapter,
-    [Permission.MediaLibraryWrite]: mediaLibraryAdapter,
-    [Permission.Microphone]: microphoneAdapter,
-    [Permission.LocationForeground]: locationAdapter,
-    [Permission.LocationBackground]: locationAdapter,
-    [Permission.Notifications]: notificationsAdapter,
-};
+const OPEN_SETTINGS_ERROR_MESSAGE = 'Unable to open application settings.';
+const adapters = new Map([
+    [Permission.Camera, cameraAdapter],
+    [Permission.MediaLibrary, mediaLibraryAdapter],
+    [Permission.MediaLibraryWrite, mediaLibraryAdapter],
+    [Permission.Microphone, microphoneAdapter],
+    [Permission.LocationForeground, locationAdapter],
+    [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) {
-            const metadata = EXPO_PERMISSION_SUPPORT[permission];
+            const metadata = getPermissionSupport(permission);
             if (metadata.support === 'unsupported' || metadata.support === 'notImplemented') {
                 return createUnavailableSupportState(permission);
             }
             if (metadata.support === 'notRequired') {
                 return createNotRequiredState(permission);
             }
-            const adapter = adapters[permission];
+            const adapter = adapters.get(permission);
             if (!adapter) {
                 throw new Error(`No adapter registered for permission: ${permission}`);
             }
             return adapter.getStatus(permission);
         },
         async request(permission) {
-            const metadata = EXPO_PERMISSION_SUPPORT[permission];
+            const metadata = getPermissionSupport(permission);
             if (metadata.support === 'unsupported' || metadata.support === 'notImplemented') {
                 return createUnavailableSupportState(permission);
             }
             if (metadata.support === 'notRequired') {
                 return createNotRequiredState(permission);
             }
-            const adapter = adapters[permission];
+            const adapter = adapters.get(permission);
             if (!adapter) {
                 throw new Error(`No adapter registered for permission: ${permission}`);
             }
             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 getPermissionSupport(permission) {
+    return Reflect.get(EXPO_PERMISSION_SUPPORT, permission);
+}
 function createUnavailableSupportState(permission) {
     return createPermissionState({
         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":"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","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 = new Map<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 = getPermissionSupport(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.get(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 = getPermissionSupport(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.get(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 getPermissionSupport(permission: Permission) {\n  return Reflect.get(EXPO_PERMISSION_SUPPORT, permission);\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/client.testSupport.d.ts

@@ -0,0 +1,54 @@
+export interface MockPermissionResponse {
+    readonly status: string;
+    readonly canAskAgain?: boolean;
+    readonly accessPrivileges?: 'all' | 'limited' | 'none';
+    readonly ios?: {
+        readonly status?: number;
+    };
+}
+type CameraMockMode = 'topLevel' | 'cameraNamespace' | 'missingExports';
+type AudioMockMode = 'topLevel' | 'audioModule' | 'missingExports';
+export declare function permissionResponse(status: string, canAskAgain?: boolean): MockPermissionResponse;
+export declare const cameraMock: {
+    mode: CameraMockMode;
+    getResponse: MockPermissionResponse;
+    requestResponse: MockPermissionResponse;
+    getError: string | undefined;
+    requestError: string | undefined;
+};
+export declare const audioMock: {
+    mode: AudioMockMode;
+    getResponse: MockPermissionResponse;
+    requestResponse: MockPermissionResponse;
+    getError: string | undefined;
+    requestError: string | undefined;
+};
+export declare const mediaLibraryMock: {
+    getResponse: MockPermissionResponse;
+    requestResponse: MockPermissionResponse;
+    getError: string | undefined;
+    requestError: string | undefined;
+    getCalls: boolean[];
+    requestCalls: boolean[];
+};
+export declare const locationMock: {
+    foregroundGetResponse: MockPermissionResponse;
+    foregroundRequestResponse: MockPermissionResponse;
+    backgroundGetResponse: MockPermissionResponse;
+    backgroundRequestResponse: MockPermissionResponse;
+    getCalls: string[];
+    requestCalls: string[];
+};
+export declare const notificationsMock: {
+    getResponse: MockPermissionResponse;
+    requestResponse: MockPermissionResponse;
+    getError: string | undefined;
+    requestError: string | undefined;
+};
+export declare const linkingMock: {
+    calls: number;
+    error: Error | undefined;
+};
+export declare function resetExpoMocks(): void;
+export {};
+//# sourceMappingURL=client.testSupport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.testSupport.d.ts","sourceRoot":"","sources":["../../src/expo/client.testSupport.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;IACvD,QAAQ,CAAC,GAAG,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,KAAK,cAAc,GAAG,UAAU,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AACxE,KAAK,aAAa,GAAG,UAAU,GAAG,aAAa,GAAG,gBAAgB,CAAC;AAEnE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,UAAO,GAAG,sBAAsB,CAE7F;AAED,eAAO,MAAM,UAAU;UACD,cAAc;;;cAGX,MAAM,GAAG,SAAS;kBACd,MAAM,GAAG,SAAS;CAC9C,CAAC;AACF,eAAO,MAAM,SAAS;UACA,aAAa;;;cAGV,MAAM,GAAG,SAAS;kBACd,MAAM,GAAG,SAAS;CAC9C,CAAC;AACF,eAAO,MAAM,gBAAgB;;;cAGJ,MAAM,GAAG,SAAS;kBACd,MAAM,GAAG,SAAS;cAC7B,OAAO,EAAE;kBACL,OAAO,EAAE;CAC9B,CAAC;AACF,eAAO,MAAM,YAAY;;;;;cAKP,MAAM,EAAE;kBACJ,MAAM,EAAE;CAC7B,CAAC;AACF,eAAO,MAAM,iBAAiB;;;cAGL,MAAM,GAAG,SAAS;kBACd,MAAM,GAAG,SAAS;CAC9C,CAAC;AACF,eAAO,MAAM,WAAW;;WAAmC,KAAK,GAAG,SAAS;CAAE,CAAC;AAsG/E,wBAAgB,cAAc,IAAI,IAAI,CAkBrC"}

package/dist/expo/client.testSupport.js

@@ -0,0 +1,183 @@
+import { mock } from 'bun:test';
+export function permissionResponse(status, canAskAgain = true) {
+    return { status, canAskAgain };
+}
+export const cameraMock = {
+    mode: 'topLevel',
+    getResponse: permissionResponse('granted'),
+    requestResponse: permissionResponse('granted'),
+    getError: undefined,
+    requestError: undefined,
+};
+export const audioMock = {
+    mode: 'topLevel',
+    getResponse: permissionResponse('granted'),
+    requestResponse: permissionResponse('granted'),
+    getError: undefined,
+    requestError: undefined,
+};
+export const mediaLibraryMock = {
+    getResponse: permissionResponse('granted'),
+    requestResponse: permissionResponse('granted'),
+    getError: undefined,
+    requestError: undefined,
+    getCalls: [],
+    requestCalls: [],
+};
+export const locationMock = {
+    foregroundGetResponse: permissionResponse('granted'),
+    foregroundRequestResponse: permissionResponse('granted'),
+    backgroundGetResponse: permissionResponse('granted'),
+    backgroundRequestResponse: permissionResponse('granted'),
+    getCalls: [],
+    requestCalls: [],
+};
+export const notificationsMock = {
+    getResponse: permissionResponse('granted'),
+    requestResponse: permissionResponse('granted'),
+    getError: undefined,
+    requestError: undefined,
+};
+export const linkingMock = { calls: 0, error: undefined };
+void mock.module('expo-camera', () => ({
+    get getCameraPermissionsAsync() {
+        if (cameraMock.mode !== 'topLevel')
+            return undefined;
+        return () => {
+            if (cameraMock.getError !== undefined)
+                throw new Error(cameraMock.getError);
+            return Promise.resolve(cameraMock.getResponse);
+        };
+    },
+    get requestCameraPermissionsAsync() {
+        if (cameraMock.mode !== 'topLevel')
+            return undefined;
+        return () => {
+            if (cameraMock.requestError !== undefined)
+                throw new Error(cameraMock.requestError);
+            return Promise.resolve(cameraMock.requestResponse);
+        };
+    },
+    get Camera() {
+        if (cameraMock.mode !== 'cameraNamespace')
+            return undefined;
+        return {
+            getCameraPermissionsAsync: () => Promise.resolve(cameraMock.getResponse),
+            requestCameraPermissionsAsync: () => Promise.resolve(cameraMock.requestResponse),
+        };
+    },
+}));
+void mock.module('expo-audio', () => ({
+    get getRecordingPermissionsAsync() {
+        if (audioMock.mode !== 'topLevel')
+            return undefined;
+        return () => {
+            if (audioMock.getError !== undefined)
+                throw new Error(audioMock.getError);
+            return Promise.resolve(audioMock.getResponse);
+        };
+    },
+    get requestRecordingPermissionsAsync() {
+        if (audioMock.mode !== 'topLevel')
+            return undefined;
+        return () => {
+            if (audioMock.requestError !== undefined)
+                throw new Error(audioMock.requestError);
+            return Promise.resolve(audioMock.requestResponse);
+        };
+    },
+    get AudioModule() {
+        if (audioMock.mode !== 'audioModule')
+            return undefined;
+        return {
+            getRecordingPermissionsAsync: () => Promise.resolve(audioMock.getResponse),
+            requestRecordingPermissionsAsync: () => Promise.resolve(audioMock.requestResponse),
+        };
+    },
+}));
+void mock.module('expo-media-library', () => ({
+    getPermissionsAsync: (writeOnly) => {
+        mediaLibraryMock.getCalls.push(writeOnly === true);
+        if (mediaLibraryMock.getError !== undefined)
+            throw new Error(mediaLibraryMock.getError);
+        return Promise.resolve(mediaLibraryMock.getResponse);
+    },
+    requestPermissionsAsync: (writeOnly) => {
+        mediaLibraryMock.requestCalls.push(writeOnly === true);
+        if (mediaLibraryMock.requestError !== undefined)
+            throw new Error(mediaLibraryMock.requestError);
+        return Promise.resolve(mediaLibraryMock.requestResponse);
+    },
+}));
+void mock.module('expo-location', () => ({
+    getForegroundPermissionsAsync: () => {
+        locationMock.getCalls.push('foreground');
+        return Promise.resolve(locationMock.foregroundGetResponse);
+    },
+    requestForegroundPermissionsAsync: () => {
+        locationMock.requestCalls.push('foreground');
+        return Promise.resolve(locationMock.foregroundRequestResponse);
+    },
+    getBackgroundPermissionsAsync: () => {
+        locationMock.getCalls.push('background');
+        return Promise.resolve(locationMock.backgroundGetResponse);
+    },
+    requestBackgroundPermissionsAsync: () => {
+        locationMock.requestCalls.push('background');
+        return Promise.resolve(locationMock.backgroundRequestResponse);
+    },
+}));
+void mock.module('expo-notifications', () => ({
+    getPermissionsAsync: () => {
+        if (notificationsMock.getError !== undefined)
+            throw new Error(notificationsMock.getError);
+        return Promise.resolve(notificationsMock.getResponse);
+    },
+    requestPermissionsAsync: () => {
+        if (notificationsMock.requestError !== undefined)
+            throw new Error(notificationsMock.requestError);
+        return Promise.resolve(notificationsMock.requestResponse);
+    },
+}));
+void mock.module('expo-linking', () => ({
+    openSettings: () => {
+        linkingMock.calls += 1;
+        if (linkingMock.error !== undefined)
+            throw linkingMock.error;
+        return Promise.resolve();
+    },
+}));
+export function resetExpoMocks() {
+    cameraMock.mode = 'topLevel';
+    cameraMock.getResponse = permissionResponse('granted');
+    cameraMock.requestResponse = permissionResponse('granted');
+    cameraMock.getError = undefined;
+    cameraMock.requestError = undefined;
+    audioMock.mode = 'topLevel';
+    audioMock.getResponse = permissionResponse('granted');
+    audioMock.requestResponse = permissionResponse('granted');
+    audioMock.getError = undefined;
+    audioMock.requestError = undefined;
+    resetCollectionMocks();
+    notificationsMock.getResponse = permissionResponse('granted');
+    notificationsMock.requestResponse = permissionResponse('granted');
+    notificationsMock.getError = undefined;
+    notificationsMock.requestError = undefined;
+    linkingMock.calls = 0;
+    linkingMock.error = undefined;
+}
+function resetCollectionMocks() {
+    mediaLibraryMock.getResponse = permissionResponse('granted');
+    mediaLibraryMock.requestResponse = permissionResponse('granted');
+    mediaLibraryMock.getError = undefined;
+    mediaLibraryMock.requestError = undefined;
+    mediaLibraryMock.getCalls.length = 0;
+    mediaLibraryMock.requestCalls.length = 0;
+    locationMock.foregroundGetResponse = permissionResponse('granted');
+    locationMock.foregroundRequestResponse = permissionResponse('granted');
+    locationMock.backgroundGetResponse = permissionResponse('granted');
+    locationMock.backgroundRequestResponse = permissionResponse('granted');
+    locationMock.getCalls.length = 0;
+    locationMock.requestCalls.length = 0;
+}
+//# sourceMappingURL=client.testSupport.js.map