@ankhorage/permissions 0.1.1 → 0.2.0

package/dist/expo/permissionResponse.js

@@ -0,0 +1,47 @@
+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,
+    });
+}
+export function createExpoUnavailableState(permission, error) {
+    return createPermissionState({
+        permission,
+        status: 'unavailable',
+        reason: getExpoPermissionErrorMessage(error),
+    });
+}
+export function findExpoPermissionMethod(source, methodName, containerNames = []) {
+    if (hasExpoPermissionMethod(source, methodName)) {
+        return source[methodName];
+    }
+    if (!isRecord(source)) {
+        return undefined;
+    }
+    for (const containerName of containerNames) {
+        const container = source[containerName];
+        if (hasExpoPermissionMethod(container, methodName)) {
+            return container[methodName];
+        }
+    }
+    return undefined;
+}
+function getExpoPermissionErrorMessage(error) {
+    if (error instanceof Error && error.message.length > 0) {
+        return error.message;
+    }
+    if (typeof error === 'string' && error.length > 0) {
+        return error;
+    }
+    return 'Expo permission operation failed.';
+}
+function hasExpoPermissionMethod(value, methodName) {
+    return isRecord(value) && typeof value[methodName] === 'function';
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+//# sourceMappingURL=permissionResponse.js.map

package/dist/expo/permissionResponse.js.map

@@ -0,0 +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"]}

package/dist/manager/createPermissionManager.d.ts

@@ -2,7 +2,7 @@ import type { PermissionClient } from '../client/types';
 import { type Permission } from '../registry/permissions';
 import { type PermissionState } from '../state/permissionState';
 /***
- * Public manager returned by `createPermissionManager`.
+ * Public facade for checking and requesting normalized permission state.
  */
 export interface PermissionManager {
     getStatus(permission: Permission): Promise<PermissionState>;
@@ -10,22 +10,11 @@ export interface PermissionManager {
     openSettings?(): Promise<void>;
 }
 /***
- * Wraps a client with registry validation and normalized results.
+ * Creates a permission manager from a runtime-specific client.
  *
  * @readme
- * Runtime permissions and build-time native configuration are separate concerns.
- * This manager checks or requests permissions through a client, but it does not
- * generate iOS usage descriptions, Android manifest entries, or Expo config
- * plugins.
- *
- * @usage
- * ```ts
- * const permissions = createPermissionManager(client);
- * const camera = await permissions.getStatus(Permission.Camera);
- * const requested = camera.granted
- *   ? camera
- *   : await permissions.request(Permission.Camera);
- * ```
+ * The manager validates permission names and normalizes client results.
+ * Native app configuration remains a separate build-time concern.
  */
 export declare function createPermissionManager(client: PermissionClient): PermissionManager;
 //# sourceMappingURL=createPermissionManager.d.ts.map

package/dist/manager/createPermissionManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createPermissionManager.d.ts","sourceRoot":"","sources":["../../src/manager/createPermissionManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAyB,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAA4B,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5D,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1D,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,CAsBnF"}
+{"version":3,"file":"createPermissionManager.d.ts","sourceRoot":"","sources":["../../src/manager/createPermissionManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAyB,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAA4B,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5D,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1D,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,CAsBnF"}

package/dist/manager/createPermissionManager.js

@@ -1,22 +1,11 @@
 import { assertKnownPermission } from '../registry/permissions';
 import { normalizePermissionState } from '../state/permissionState';
 /***
- * Wraps a client with registry validation and normalized results.
+ * Creates a permission manager from a runtime-specific client.
  *
  * @readme
- * Runtime permissions and build-time native configuration are separate concerns.
- * This manager checks or requests permissions through a client, but it does not
- * generate iOS usage descriptions, Android manifest entries, or Expo config
- * plugins.
- *
- * @usage
- * ```ts
- * const permissions = createPermissionManager(client);
- * const camera = await permissions.getStatus(Permission.Camera);
- * const requested = camera.granted
- *   ? camera
- *   : await permissions.request(Permission.Camera);
- * ```
+ * The manager validates permission names and normalizes client results.
+ * Native app configuration remains a separate build-time concern.
  */
 export function createPermissionManager(client) {
     const manager = {

package/dist/manager/createPermissionManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"createPermissionManager.js","sourceRoot":"","sources":["../../src/manager/createPermissionManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAmB,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAwB,MAAM,0BAA0B,CAAC;AAW1F;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAwB;IAC9D,MAAM,OAAO,GAAsB;QACjC,KAAK,CAAC,SAAS,CAAC,UAAU;YACxB,MAAM,eAAe,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;YAC1D,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;YAEtD,OAAO,wBAAwB,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;QAC1D,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,UAAU;YACtB,MAAM,eAAe,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;YAC1D,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YAEpD,OAAO,wBAAwB,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;QAC1D,CAAC;KACF,CAAC;IAEF,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,CAAC,YAAY,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5E,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import type { PermissionClient } from '../client/types';\nimport { assertKnownPermission, type Permission } from '../registry/permissions';\nimport { normalizePermissionState, type PermissionState } from '../state/permissionState';\n\n/***\n * Public manager returned by `createPermissionManager`.\n */\nexport interface PermissionManager {\n  getStatus(permission: Permission): Promise<PermissionState>;\n  request(permission: Permission): Promise<PermissionState>;\n  openSettings?(): Promise<void>;\n}\n\n/***\n * Wraps a client with registry validation and normalized results.\n *\n * @readme\n * Runtime permissions and build-time native configuration are separate concerns.\n * This manager checks or requests permissions through a client, but it does not\n * generate iOS usage descriptions, Android manifest entries, or Expo config\n * plugins.\n *\n * @usage\n * ```ts\n * const permissions = createPermissionManager(client);\n * const camera = await permissions.getStatus(Permission.Camera);\n * const requested = camera.granted\n *   ? camera\n *   : await permissions.request(Permission.Camera);\n * ```\n */\nexport function createPermissionManager(client: PermissionClient): PermissionManager {\n  const manager: PermissionManager = {\n    async getStatus(permission) {\n      const knownPermission = assertKnownPermission(permission);\n      const state = await client.getStatus(knownPermission);\n\n      return normalizePermissionState(knownPermission, state);\n    },\n\n    async request(permission) {\n      const knownPermission = assertKnownPermission(permission);\n      const state = await client.request(knownPermission);\n\n      return normalizePermissionState(knownPermission, state);\n    },\n  };\n\n  if (client.openSettings !== undefined) {\n    manager.openSettings = () => client.openSettings?.() ?? Promise.resolve();\n  }\n\n  return manager;\n}\n"]}
+{"version":3,"file":"createPermissionManager.js","sourceRoot":"","sources":["../../src/manager/createPermissionManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAmB,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAwB,MAAM,0BAA0B,CAAC;AAW1F;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAwB;IAC9D,MAAM,OAAO,GAAsB;QACjC,KAAK,CAAC,SAAS,CAAC,UAAU;YACxB,MAAM,eAAe,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;YAC1D,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;YAEtD,OAAO,wBAAwB,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;QAC1D,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,UAAU;YACtB,MAAM,eAAe,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;YAC1D,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YAEpD,OAAO,wBAAwB,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;QAC1D,CAAC;KACF,CAAC;IAEF,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,CAAC,YAAY,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5E,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import type { PermissionClient } from '../client/types';\nimport { assertKnownPermission, type Permission } from '../registry/permissions';\nimport { normalizePermissionState, type PermissionState } from '../state/permissionState';\n\n/***\n * Public facade for checking and requesting normalized permission state.\n */\nexport interface PermissionManager {\n  getStatus(permission: Permission): Promise<PermissionState>;\n  request(permission: Permission): Promise<PermissionState>;\n  openSettings?(): Promise<void>;\n}\n\n/***\n * Creates a permission manager from a runtime-specific client.\n *\n * @readme\n * The manager validates permission names and normalizes client results.\n * Native app configuration remains a separate build-time concern.\n */\nexport function createPermissionManager(client: PermissionClient): PermissionManager {\n  const manager: PermissionManager = {\n    async getStatus(permission) {\n      const knownPermission = assertKnownPermission(permission);\n      const state = await client.getStatus(knownPermission);\n\n      return normalizePermissionState(knownPermission, state);\n    },\n\n    async request(permission) {\n      const knownPermission = assertKnownPermission(permission);\n      const state = await client.request(knownPermission);\n\n      return normalizePermissionState(knownPermission, state);\n    },\n  };\n\n  if (client.openSettings !== undefined) {\n    manager.openSettings = () => client.openSettings?.() ?? Promise.resolve();\n  }\n\n  return manager;\n}\n"]}

package/dist/react/index.d.ts

@@ -47,20 +47,6 @@ export declare function PermissionsProvider({ children, client, manager, }: Perm
 export declare function usePermissions(): PermissionManager;
 /***
  * Tracks a single permission and exposes explicit refresh/request actions.
- *
- * @usage
- * ```tsx
- * const camera = usePermission(Permission.Camera, { refreshOnMount: true });
- *
- * return (
- *   <Button
- *     disabled={camera.granted}
- *     onPress={() => {
- *       void camera.request();
- *     }}
- *   />
- * );
- * ```
  */
 export declare function usePermission(permission: Permission, options?: UsePermissionOptions): PermissionHookResult;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,0BAA0B,CAAC;AAIlC;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,eAAe,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,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;IACzB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,MAAM,EACN,OAAO,GACR,EAAE,wBAAwB,GAAG,SAAS,CActC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,iBAAiB,CAQlD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,oBAAyB,GACjC,oBAAoB,CAkDtB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,0BAA0B,CAAC;AAIlC;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,eAAe,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,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;IACzB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,MAAM,EACN,OAAO,GACR,EAAE,wBAAwB,GAAG,SAAS,CActC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,iBAAiB,CAQlD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,oBAAyB,GACjC,oBAAoB,CAkDtB"}

package/dist/react/index.js

@@ -33,20 +33,6 @@ export function usePermissions() {
 }
 /***
  * Tracks a single permission and exposes explicit refresh/request actions.
- *
- * @usage
- * ```tsx
- * const camera = usePermission(Permission.Camera, { refreshOnMount: true });
- *
- * return (
- *   <Button
- *     disabled={camera.granted}
- *     onPress={() => {
- *       void camera.request();
- *     }}
- *   />
- * );
- * ```
  */
 export function usePermission(permission, options = {}) {
     const manager = usePermissions();

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  createContext,\n  createElement,\n  type ReactNode,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n} from 'react';\n\nimport type { PermissionClient } from '../client/types';\nimport {\n  createPermissionManager,\n  type PermissionManager,\n} from '../manager/createPermissionManager';\nimport type { Permission } from '../registry/permissions';\nimport {\n  createPermissionState,\n  normalizePermissionState,\n  type PermissionState,\n  type PermissionStatus,\n} from '../state/permissionState';\n\nconst PermissionsContext = createContext<PermissionManager | undefined>(undefined);\n\n/***\n * Props accepted by `PermissionsProvider`.\n */\nexport interface PermissionsProviderProps {\n  readonly children: ReactNode;\n  readonly client?: PermissionClient;\n  readonly manager?: PermissionManager;\n}\n\n/***\n * Options for `usePermission`.\n */\nexport interface UsePermissionOptions {\n  readonly initialState?: PermissionState;\n  readonly refreshOnMount?: boolean;\n}\n\n/***\n * Result returned by `usePermission`.\n */\nexport interface PermissionHookResult {\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  readonly state: PermissionState;\n  readonly refresh: () => Promise<PermissionState>;\n  readonly request: () => Promise<PermissionState>;\n  readonly openSettings?: () => Promise<void>;\n}\n\n/***\n * Provides a permission manager to React hooks.\n *\n * @readme\n * React helpers are framework-neutral. They depend on React only and do not\n * import browser, Expo, or React Native permission APIs.\n */\nexport function PermissionsProvider({\n  children,\n  client,\n  manager,\n}: PermissionsProviderProps): ReactNode {\n  const resolvedManager = useMemo(() => {\n    if (manager !== undefined) {\n      return manager;\n    }\n\n    if (client !== undefined) {\n      return createPermissionManager(client);\n    }\n\n    throw new Error('PermissionsProvider requires a client or manager.');\n  }, [client, manager]);\n\n  return createElement(PermissionsContext.Provider, { value: resolvedManager }, children);\n}\n\n/***\n * Reads the current permission manager from context.\n */\nexport function usePermissions(): PermissionManager {\n  const manager = useContext(PermissionsContext);\n\n  if (manager === undefined) {\n    throw new Error('usePermissions must be used within PermissionsProvider.');\n  }\n\n  return manager;\n}\n\n/***\n * Tracks a single permission and exposes explicit refresh/request actions.\n *\n * @usage\n * ```tsx\n * const camera = usePermission(Permission.Camera, { refreshOnMount: true });\n *\n * return (\n *   <Button\n *     disabled={camera.granted}\n *     onPress={() => {\n *       void camera.request();\n *     }}\n *   />\n * );\n * ```\n */\nexport function usePermission(\n  permission: Permission,\n  options: UsePermissionOptions = {},\n): PermissionHookResult {\n  const manager = usePermissions();\n  const [state, setState] = useState<PermissionState>(\n    () =>\n      (options.initialState === undefined\n        ? undefined\n        : normalizePermissionState(permission, options.initialState)) ??\n      createPermissionState({\n        permission,\n        status: 'unknown',\n      }),\n  );\n\n  const refresh = useCallback(async () => {\n    const nextState = await manager.getStatus(permission);\n    setState(nextState);\n\n    return nextState;\n  }, [manager, permission]);\n\n  const request = useCallback(async () => {\n    const nextState = await manager.request(permission);\n    setState(nextState);\n\n    return nextState;\n  }, [manager, permission]);\n\n  useEffect(() => {\n    if (options.refreshOnMount === true) {\n      void refresh();\n    }\n  }, [options.refreshOnMount, refresh]);\n\n  const openSettings =\n    manager.openSettings === undefined\n      ? undefined\n      : () => manager.openSettings?.() ?? Promise.resolve();\n\n  return {\n    permission: state.permission,\n    status: state.status,\n    canAskAgain: state.canAskAgain,\n    granted: state.granted,\n    requestedAt: state.requestedAt,\n    reason: state.reason,\n    state,\n    refresh,\n    request,\n    openSettings,\n  };\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  createContext,\n  createElement,\n  type ReactNode,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n} from 'react';\n\nimport type { PermissionClient } from '../client/types';\nimport {\n  createPermissionManager,\n  type PermissionManager,\n} from '../manager/createPermissionManager';\nimport type { Permission } from '../registry/permissions';\nimport {\n  createPermissionState,\n  normalizePermissionState,\n  type PermissionState,\n  type PermissionStatus,\n} from '../state/permissionState';\n\nconst PermissionsContext = createContext<PermissionManager | undefined>(undefined);\n\n/***\n * Props accepted by `PermissionsProvider`.\n */\nexport interface PermissionsProviderProps {\n  readonly children: ReactNode;\n  readonly client?: PermissionClient;\n  readonly manager?: PermissionManager;\n}\n\n/***\n * Options for `usePermission`.\n */\nexport interface UsePermissionOptions {\n  readonly initialState?: PermissionState;\n  readonly refreshOnMount?: boolean;\n}\n\n/***\n * Result returned by `usePermission`.\n */\nexport interface PermissionHookResult {\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  readonly state: PermissionState;\n  readonly refresh: () => Promise<PermissionState>;\n  readonly request: () => Promise<PermissionState>;\n  readonly openSettings?: () => Promise<void>;\n}\n\n/***\n * Provides a permission manager to React hooks.\n *\n * @readme\n * React helpers are framework-neutral. They depend on React only and do not\n * import browser, Expo, or React Native permission APIs.\n */\nexport function PermissionsProvider({\n  children,\n  client,\n  manager,\n}: PermissionsProviderProps): ReactNode {\n  const resolvedManager = useMemo(() => {\n    if (manager !== undefined) {\n      return manager;\n    }\n\n    if (client !== undefined) {\n      return createPermissionManager(client);\n    }\n\n    throw new Error('PermissionsProvider requires a client or manager.');\n  }, [client, manager]);\n\n  return createElement(PermissionsContext.Provider, { value: resolvedManager }, children);\n}\n\n/***\n * Reads the current permission manager from context.\n */\nexport function usePermissions(): PermissionManager {\n  const manager = useContext(PermissionsContext);\n\n  if (manager === undefined) {\n    throw new Error('usePermissions must be used within PermissionsProvider.');\n  }\n\n  return manager;\n}\n\n/***\n * Tracks a single permission and exposes explicit refresh/request actions.\n */\nexport function usePermission(\n  permission: Permission,\n  options: UsePermissionOptions = {},\n): PermissionHookResult {\n  const manager = usePermissions();\n  const [state, setState] = useState<PermissionState>(\n    () =>\n      (options.initialState === undefined\n        ? undefined\n        : normalizePermissionState(permission, options.initialState)) ??\n      createPermissionState({\n        permission,\n        status: 'unknown',\n      }),\n  );\n\n  const refresh = useCallback(async () => {\n    const nextState = await manager.getStatus(permission);\n    setState(nextState);\n\n    return nextState;\n  }, [manager, permission]);\n\n  const request = useCallback(async () => {\n    const nextState = await manager.request(permission);\n    setState(nextState);\n\n    return nextState;\n  }, [manager, permission]);\n\n  useEffect(() => {\n    if (options.refreshOnMount === true) {\n      void refresh();\n    }\n  }, [options.refreshOnMount, refresh]);\n\n  const openSettings =\n    manager.openSettings === undefined\n      ? undefined\n      : () => manager.openSettings?.() ?? Promise.resolve();\n\n  return {\n    permission: state.permission,\n    status: state.status,\n    canAskAgain: state.canAskAgain,\n    granted: state.granted,\n    requestedAt: state.requestedAt,\n    reason: state.reason,\n    state,\n    refresh,\n    request,\n    openSettings,\n  };\n}\n"]}

package/dist/testing/index.d.ts

@@ -36,14 +36,6 @@ export interface FakePermissionClient extends PermissionClient {
  * @readme
  * Fake clients make permission flows testable without native devices, browser
  * prompts, simulators, or network access.
- *
- * @usage
- * ```ts
- * const client = createFakePermissionClient({
- *   initialStates: [{ permission: Permission.Camera, status: 'denied' }],
- * });
- * await client.request(Permission.Camera);
- * ```
  */
 export declare function createFakePermissionClient(options?: FakePermissionClientOptions): FakePermissionClient;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAC/B,eAAe,GACf;IACE,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,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC5D,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC5D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,QAAQ,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC/C,SAAS,CACP,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;QAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;KAC1B,GACA,IAAI,CAAC;IACR,WAAW,IAAI,SAAS,eAAe,EAAE,CAAC;CAC3C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,2BAAgC,GACxC,oBAAoB,CA4EtB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAC/B,eAAe,GACf;IACE,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,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC5D,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC5D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,QAAQ,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC/C,SAAS,CACP,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;QAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;KAC1B,GACA,IAAI,CAAC;IACR,WAAW,IAAI,SAAS,eAAe,EAAE,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,2BAAgC,GACxC,oBAAoB,CA4EtB"}

package/dist/testing/index.js

@@ -6,14 +6,6 @@ import { createPermissionState, } from '../state/permissionState';
  * @readme
  * Fake clients make permission flows testable without native devices, browser
  * prompts, simulators, or network access.
- *
- * @usage
- * ```ts
- * const client = createFakePermissionClient({
- *   initialStates: [{ permission: Permission.Camera, status: 'denied' }],
- * });
- * await client.request(Permission.Camera);
- * ```
  */
 export function createFakePermissionClient(options = {}) {
     const now = options.now ?? (() => new Date());

package/dist/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PermissionClient } from '../client/types';\nimport type { Permission } from '../registry/permissions';\nimport { assertKnownPermission, PERMISSIONS } from '../registry/permissions';\nimport {\n  createPermissionState,\n  type PermissionState,\n  type PermissionStatus,\n} from '../state/permissionState';\n\n/***\n * Seed format accepted by the fake client.\n */\nexport type FakePermissionStateSeed =\n  | PermissionState\n  | {\n      readonly permission: Permission;\n      readonly status: PermissionStatus;\n      readonly canAskAgain?: boolean;\n      readonly reason?: string;\n    };\n\n/***\n * Options for deterministic fake clients.\n */\nexport interface FakePermissionClientOptions {\n  readonly initialStates?: readonly FakePermissionStateSeed[];\n  readonly requestStates?: readonly FakePermissionStateSeed[];\n  readonly now?: () => Date;\n  readonly openSettings?: () => Promise<void>;\n}\n\n/***\n * Test client that stores permission states in memory.\n */\nexport interface FakePermissionClient extends PermissionClient {\n  setState(state: FakePermissionStateSeed): void;\n  setStatus(\n    permission: Permission,\n    status: PermissionStatus,\n    options?: {\n      readonly canAskAgain?: boolean;\n      readonly reason?: string;\n    },\n  ): void;\n  getSnapshot(): readonly PermissionState[];\n}\n\n/***\n * Creates a deterministic in-memory client for tests and examples.\n *\n * @readme\n * Fake clients make permission flows testable without native devices, browser\n * prompts, simulators, or network access.\n *\n * @usage\n * ```ts\n * const client = createFakePermissionClient({\n *   initialStates: [{ permission: Permission.Camera, status: 'denied' }],\n * });\n * await client.request(Permission.Camera);\n * ```\n */\nexport function createFakePermissionClient(\n  options: FakePermissionClientOptions = {},\n): FakePermissionClient {\n  const now = options.now ?? (() => new Date());\n  const states = new Map<Permission, PermissionState>();\n  const requestStates = new Map<Permission, PermissionState>();\n\n  for (const permission of PERMISSIONS) {\n    states.set(\n      permission,\n      createPermissionState({\n        permission,\n        status: 'unknown',\n        canAskAgain: true,\n      }),\n    );\n  }\n\n  for (const state of options.initialStates ?? []) {\n    states.set(state.permission, normalizeSeed(state));\n  }\n\n  for (const state of options.requestStates ?? []) {\n    requestStates.set(state.permission, normalizeSeed(state));\n  }\n\n  const client: FakePermissionClient = {\n    getStatus(permission) {\n      return Promise.resolve(getStoredState(states, assertKnownPermission(permission)));\n    },\n\n    request(permission) {\n      const knownPermission = assertKnownPermission(permission);\n      const requestState =\n        requestStates.get(knownPermission) ?? getStoredState(states, knownPermission);\n      const nextState = createPermissionState({\n        permission: knownPermission,\n        status: requestState.status,\n        canAskAgain: requestState.canAskAgain,\n        requestedAt: now(),\n        reason: requestState.reason,\n      });\n\n      states.set(knownPermission, nextState);\n\n      return Promise.resolve(nextState);\n    },\n\n    openSettings: options.openSettings,\n\n    setState(state) {\n      const normalizedState = normalizeSeed(state);\n      states.set(normalizedState.permission, normalizedState);\n    },\n\n    setStatus(permission, status, statusOptions = {}) {\n      const knownPermission = assertKnownPermission(permission);\n      states.set(\n        knownPermission,\n        createPermissionState({\n          permission: knownPermission,\n          status,\n          canAskAgain: statusOptions.canAskAgain,\n          reason: statusOptions.reason,\n        }),\n      );\n    },\n\n    getSnapshot() {\n      return PERMISSIONS.map((permission) => getStoredState(states, permission));\n    },\n  };\n\n  if (options.openSettings === undefined) {\n    delete client.openSettings;\n  }\n\n  return client;\n}\n\nfunction normalizeSeed(seed: FakePermissionStateSeed): PermissionState {\n  return createPermissionState({\n    permission: assertKnownPermission(seed.permission),\n    status: seed.status,\n    canAskAgain: seed.canAskAgain,\n    requestedAt: 'requestedAt' in seed ? seed.requestedAt : undefined,\n    reason: seed.reason,\n  });\n}\n\nfunction getStoredState(\n  states: ReadonlyMap<Permission, PermissionState>,\n  permission: Permission,\n): PermissionState {\n  const state = states.get(permission);\n\n  if (state === undefined) {\n    return createPermissionState({\n      permission,\n      status: 'unknown',\n      canAskAgain: true,\n    });\n  }\n\n  return state;\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EACL,qBAAqB,GAGtB,MAAM,0BAA0B,CAAC;AAwClC;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAuC,EAAE;IAEzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,GAAG,EAA+B,CAAC;IACtD,MAAM,aAAa,GAAG,IAAI,GAAG,EAA+B,CAAC;IAE7D,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CACR,UAAU,EACV,qBAAqB,CAAC;YACpB,UAAU;YACV,MAAM,EAAE,SAAS;YACjB,WAAW,EAAE,IAAI;SAClB,CAAC,CACH,CAAC;IACJ,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;QAChD,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,MAAM,GAAyB;QACnC,SAAS,CAAC,UAAU;YAClB,OAAO,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACpF,CAAC;QAED,OAAO,CAAC,UAAU;YAChB,MAAM,eAAe,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;YAC1D,MAAM,YAAY,GAChB,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,cAAc,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;YAChF,MAAM,SAAS,GAAG,qBAAqB,CAAC;gBACtC,UAAU,EAAE,eAAe;gBAC3B,MAAM,EAAE,YAAY,CAAC,MAAM;gBAC3B,WAAW,EAAE,YAAY,CAAC,WAAW;gBACrC,WAAW,EAAE,GAAG,EAAE;gBAClB,MAAM,EAAE,YAAY,CAAC,MAAM;aAC5B,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;YAEvC,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;QAED,YAAY,EAAE,OAAO,CAAC,YAAY;QAElC,QAAQ,CAAC,KAAK;YACZ,MAAM,eAAe,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;QAC1D,CAAC;QAED,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,GAAG,EAAE;YAC9C,MAAM,eAAe,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;YAC1D,MAAM,CAAC,GAAG,CACR,eAAe,EACf,qBAAqB,CAAC;gBACpB,UAAU,EAAE,eAAe;gBAC3B,MAAM;gBACN,WAAW,EAAE,aAAa,CAAC,WAAW;gBACtC,MAAM,EAAE,aAAa,CAAC,MAAM;aAC7B,CAAC,CACH,CAAC;QACJ,CAAC;QAED,WAAW;YACT,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;QAC7E,CAAC;KACF,CAAC;IAEF,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,IAA6B;IAClD,OAAO,qBAAqB,CAAC;QAC3B,UAAU,EAAE,qBAAqB,CAAC,IAAI,CAAC,UAAU,CAAC;QAClD,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;QACjE,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CACrB,MAAgD,EAChD,UAAsB;IAEtB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAErC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,qBAAqB,CAAC;YAC3B,UAAU;YACV,MAAM,EAAE,SAAS;YACjB,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import type { PermissionClient } from '../client/types';\nimport type { Permission } from '../registry/permissions';\nimport { assertKnownPermission, PERMISSIONS } from '../registry/permissions';\nimport {\n  createPermissionState,\n  type PermissionState,\n  type PermissionStatus,\n} from '../state/permissionState';\n\n/***\n * Seed format accepted by the fake client.\n */\nexport type FakePermissionStateSeed =\n  | PermissionState\n  | {\n      readonly permission: Permission;\n      readonly status: PermissionStatus;\n      readonly canAskAgain?: boolean;\n      readonly reason?: string;\n    };\n\n/***\n * Options for deterministic fake clients.\n */\nexport interface FakePermissionClientOptions {\n  readonly initialStates?: readonly FakePermissionStateSeed[];\n  readonly requestStates?: readonly FakePermissionStateSeed[];\n  readonly now?: () => Date;\n  readonly openSettings?: () => Promise<void>;\n}\n\n/***\n * Test client that stores permission states in memory.\n */\nexport interface FakePermissionClient extends PermissionClient {\n  setState(state: FakePermissionStateSeed): void;\n  setStatus(\n    permission: Permission,\n    status: PermissionStatus,\n    options?: {\n      readonly canAskAgain?: boolean;\n      readonly reason?: string;\n    },\n  ): void;\n  getSnapshot(): readonly PermissionState[];\n}\n\n/***\n * Creates a deterministic in-memory client for tests and examples.\n *\n * @readme\n * Fake clients make permission flows testable without native devices, browser\n * prompts, simulators, or network access.\n */\nexport function createFakePermissionClient(\n  options: FakePermissionClientOptions = {},\n): FakePermissionClient {\n  const now = options.now ?? (() => new Date());\n  const states = new Map<Permission, PermissionState>();\n  const requestStates = new Map<Permission, PermissionState>();\n\n  for (const permission of PERMISSIONS) {\n    states.set(\n      permission,\n      createPermissionState({\n        permission,\n        status: 'unknown',\n        canAskAgain: true,\n      }),\n    );\n  }\n\n  for (const state of options.initialStates ?? []) {\n    states.set(state.permission, normalizeSeed(state));\n  }\n\n  for (const state of options.requestStates ?? []) {\n    requestStates.set(state.permission, normalizeSeed(state));\n  }\n\n  const client: FakePermissionClient = {\n    getStatus(permission) {\n      return Promise.resolve(getStoredState(states, assertKnownPermission(permission)));\n    },\n\n    request(permission) {\n      const knownPermission = assertKnownPermission(permission);\n      const requestState =\n        requestStates.get(knownPermission) ?? getStoredState(states, knownPermission);\n      const nextState = createPermissionState({\n        permission: knownPermission,\n        status: requestState.status,\n        canAskAgain: requestState.canAskAgain,\n        requestedAt: now(),\n        reason: requestState.reason,\n      });\n\n      states.set(knownPermission, nextState);\n\n      return Promise.resolve(nextState);\n    },\n\n    openSettings: options.openSettings,\n\n    setState(state) {\n      const normalizedState = normalizeSeed(state);\n      states.set(normalizedState.permission, normalizedState);\n    },\n\n    setStatus(permission, status, statusOptions = {}) {\n      const knownPermission = assertKnownPermission(permission);\n      states.set(\n        knownPermission,\n        createPermissionState({\n          permission: knownPermission,\n          status,\n          canAskAgain: statusOptions.canAskAgain,\n          reason: statusOptions.reason,\n        }),\n      );\n    },\n\n    getSnapshot() {\n      return PERMISSIONS.map((permission) => getStoredState(states, permission));\n    },\n  };\n\n  if (options.openSettings === undefined) {\n    delete client.openSettings;\n  }\n\n  return client;\n}\n\nfunction normalizeSeed(seed: FakePermissionStateSeed): PermissionState {\n  return createPermissionState({\n    permission: assertKnownPermission(seed.permission),\n    status: seed.status,\n    canAskAgain: seed.canAskAgain,\n    requestedAt: 'requestedAt' in seed ? seed.requestedAt : undefined,\n    reason: seed.reason,\n  });\n}\n\nfunction getStoredState(\n  states: ReadonlyMap<Permission, PermissionState>,\n  permission: Permission,\n): PermissionState {\n  const state = states.get(permission);\n\n  if (state === undefined) {\n    return createPermissionState({\n      permission,\n      status: 'unknown',\n      canAskAgain: true,\n    });\n  }\n\n  return state;\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/permissions",
   "type": "module",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Cross-platform permission registry and runtime helpers for TypeScript apps, with unified request/check APIs for camera, media, location, notifications, microphone, etc. and web/native capabilities.",
   "homepage": "https://github.com/ankhorage/permissions#readme",
   "bugs": {
@@ -73,6 +73,18 @@
       "import": "./dist/web/index.js",
       "default": "./dist/web/index.js"
     },
+    "./expo": {
+      "react-native": "./dist/expo/index.js",
+      "types": "./dist/expo/index.d.ts",
+      "import": "./dist/expo/index.js",
+      "default": "./dist/expo/index.js"
+    },
+    "./expo/manifest": {
+      "react-native": "./dist/expo/manifest.js",
+      "types": "./dist/expo/manifest.d.ts",
+      "import": "./dist/expo/manifest.js",
+      "default": "./dist/expo/manifest.js"
+    },
     "./metadata": {
       "react-native": "./dist/metadata/index.js",
       "browser": "./dist/metadata/index.js",

package/src/client/types.ts

@@ -2,15 +2,9 @@ import type { Permission } from '../registry/permissions';
 import type { PermissionState } from '../state/permissionState';
 
 /***
- * Adapter-neutral interface for runtime permission checks and requests.
+ * Adapter-neutral contract for checking and requesting permissions.
  *
- * @usage
- * ```ts
- * const state = await client.getStatus(Permission.Camera);
- * if (!state.granted) {
- *   await client.request(Permission.Camera);
- * }
- * ```
+ * Implementations provide permission state and permission requests for a runtime environment.
  */
 export interface PermissionClient {
   getStatus(permission: Permission): Promise<PermissionState>;

package/src/expo/adapters/camera.ts

@@ -0,0 +1,52 @@
+import type { Permission } from '../../registry/permissions';
+import type { PermissionState } from '../../state/permissionState';
+import type { ExpoPermissionAdapter } from '../client';
+import {
+  createExpoPermissionState,
+  createExpoUnavailableState,
+  type ExpoPermissionMethod,
+  findExpoPermissionMethod,
+} from '../permissionResponse';
+
+const CAMERA_PERMISSION_CONTAINER_NAMES = ['CameraNativeModule', 'Camera'] as const;
+
+export const cameraAdapter: ExpoPermissionAdapter = {
+  async getStatus(permission: Permission): Promise<PermissionState> {
+    try {
+      const result = await resolveCameraPermissionMethod(
+        await import('expo-camera'),
+        'getCameraPermissionsAsync',
+      )();
+
+      return createExpoPermissionState(permission, result);
+    } catch (error) {
+      return createExpoUnavailableState(permission, error);
+    }
+  },
+
+  async request(permission: Permission): Promise<PermissionState> {
+    try {
+      const result = await resolveCameraPermissionMethod(
+        await import('expo-camera'),
+        'requestCameraPermissionsAsync',
+      )();
+
+      return createExpoPermissionState(permission, result);
+    } catch (error) {
+      return createExpoUnavailableState(permission, error);
+    }
+  },
+};
+
+function resolveCameraPermissionMethod(
+  source: unknown,
+  methodName: 'getCameraPermissionsAsync' | 'requestCameraPermissionsAsync',
+): ExpoPermissionMethod {
+  const method = findExpoPermissionMethod(source, methodName, CAMERA_PERMISSION_CONTAINER_NAMES);
+
+  if (method === undefined) {
+    throw new Error(`expo-camera does not export ${methodName}.`);
+  }
+
+  return method;
+}

package/src/expo/adapters/location.ts

@@ -0,0 +1,34 @@
+import { Permission } from '../../registry/permissions';
+import type { PermissionState } from '../../state/permissionState';
+import type { ExpoPermissionAdapter } from '../client';
+import { createExpoPermissionState, createExpoUnavailableState } from '../permissionResponse';
+
+export const locationAdapter: ExpoPermissionAdapter = {
+  async getStatus(permission: Permission): Promise<PermissionState> {
+    try {
+      const mod = await import('expo-location');
+      const isBackground = permission === Permission.LocationBackground;
+      const result = isBackground
+        ? await mod.getBackgroundPermissionsAsync()
+        : await mod.getForegroundPermissionsAsync();
+
+      return createExpoPermissionState(permission, result);
+    } catch (error) {
+      return createExpoUnavailableState(permission, error);
+    }
+  },
+
+  async request(permission: Permission): Promise<PermissionState> {
+    try {
+      const mod = await import('expo-location');
+      const isBackground = permission === Permission.LocationBackground;
+      const result = isBackground
+        ? await mod.requestBackgroundPermissionsAsync()
+        : await mod.requestForegroundPermissionsAsync();
+
+      return createExpoPermissionState(permission, result);
+    } catch (error) {
+      return createExpoUnavailableState(permission, error);
+    }
+  },
+};

package/src/expo/adapters/mediaLibrary.ts

@@ -0,0 +1,33 @@
+import type { Permission } from '../../registry/permissions';
+import { Permission as KnownPermission } from '../../registry/permissions';
+import type { PermissionState } from '../../state/permissionState';
+import type { ExpoPermissionAdapter } from '../client';
+import { createExpoPermissionState, createExpoUnavailableState } from '../permissionResponse';
+
+export const mediaLibraryAdapter: ExpoPermissionAdapter = {
+  async getStatus(permission: Permission): Promise<PermissionState> {
+    try {
+      const mod = await import('expo-media-library');
+      const result = await mod.getPermissionsAsync(isWriteOnlyPermission(permission));
+
+      return createExpoPermissionState(permission, result);
+    } catch (error) {
+      return createExpoUnavailableState(permission, error);
+    }
+  },
+
+  async request(permission: Permission): Promise<PermissionState> {
+    try {
+      const mod = await import('expo-media-library');
+      const result = await mod.requestPermissionsAsync(isWriteOnlyPermission(permission));
+
+      return createExpoPermissionState(permission, result);
+    } catch (error) {
+      return createExpoUnavailableState(permission, error);
+    }
+  },
+};
+
+function isWriteOnlyPermission(permission: Permission): boolean {
+  return permission === KnownPermission.MediaLibraryWrite;
+}

package/src/expo/adapters/microphone.ts

@@ -0,0 +1,52 @@
+import type { Permission } from '../../registry/permissions';
+import type { PermissionState } from '../../state/permissionState';
+import type { ExpoPermissionAdapter } from '../client';
+import {
+  createExpoPermissionState,
+  createExpoUnavailableState,
+  type ExpoPermissionMethod,
+  findExpoPermissionMethod,
+} from '../permissionResponse';
+
+const AUDIO_PERMISSION_CONTAINER_NAMES = ['AudioModule', 'Audio'] as const;
+
+export const microphoneAdapter: ExpoPermissionAdapter = {
+  async getStatus(permission: Permission): Promise<PermissionState> {
+    try {
+      const result = await resolveAudioPermissionMethod(
+        await import('expo-audio'),
+        'getRecordingPermissionsAsync',
+      )();
+
+      return createExpoPermissionState(permission, result);
+    } catch (error) {
+      return createExpoUnavailableState(permission, error);
+    }
+  },
+
+  async request(permission: Permission): Promise<PermissionState> {
+    try {
+      const result = await resolveAudioPermissionMethod(
+        await import('expo-audio'),
+        'requestRecordingPermissionsAsync',
+      )();
+
+      return createExpoPermissionState(permission, result);
+    } catch (error) {
+      return createExpoUnavailableState(permission, error);
+    }
+  },
+};
+
+function resolveAudioPermissionMethod(
+  source: unknown,
+  methodName: 'getRecordingPermissionsAsync' | 'requestRecordingPermissionsAsync',
+): ExpoPermissionMethod {
+  const method = findExpoPermissionMethod(source, methodName, AUDIO_PERMISSION_CONTAINER_NAMES);
+
+  if (method === undefined) {
+    throw new Error(`expo-audio does not export ${methodName}.`);
+  }
+
+  return method;
+}

package/src/expo/adapters/notifications.ts

@@ -0,0 +1,28 @@
+import type { Permission } from '../../registry/permissions';
+import type { PermissionState } from '../../state/permissionState';
+import type { ExpoPermissionAdapter } from '../client';
+import { createExpoPermissionState, createExpoUnavailableState } from '../permissionResponse';
+
+export const notificationsAdapter: ExpoPermissionAdapter = {
+  async getStatus(permission: Permission): Promise<PermissionState> {
+    try {
+      const mod = await import('expo-notifications');
+      const result = await mod.getPermissionsAsync();
+
+      return createExpoPermissionState(permission, result);
+    } catch (error) {
+      return createExpoUnavailableState(permission, error);
+    }
+  },
+
+  async request(permission: Permission): Promise<PermissionState> {
+    try {
+      const mod = await import('expo-notifications');
+      const result = await mod.requestPermissionsAsync();
+
+      return createExpoPermissionState(permission, result);
+    } catch (error) {
+      return createExpoUnavailableState(permission, error);
+    }
+  },
+};