@ankhorage/permissions 0.2.2 → 0.2.4

package/dist/web/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PermissionClient } from '../client/types';\nimport { assertKnownPermission, Permission } from '../registry/permissions';\nimport {\n  createPermissionState,\n  type PermissionState,\n  type PermissionStatus,\n} from '../state/permissionState';\n\ntype BrowserPermissionName = 'camera' | 'microphone' | 'geolocation' | 'notifications';\ntype BrowserPermissionState = 'granted' | 'denied' | 'prompt';\ntype NotificationPermissionState = 'default' | 'denied' | 'granted';\n\ninterface BrowserPermissionStatus {\n  readonly state: BrowserPermissionState;\n}\n\ninterface BrowserPermissions {\n  query(descriptor: { readonly name: BrowserPermissionName }): Promise<BrowserPermissionStatus>;\n}\n\ninterface MediaStreamTrackLike {\n  stop(): void;\n}\n\ninterface MediaStreamLike {\n  getTracks(): readonly MediaStreamTrackLike[];\n}\n\ninterface MediaDevicesLike {\n  getUserMedia(constraints: {\n    readonly audio?: boolean;\n    readonly video?: boolean;\n  }): Promise<MediaStreamLike>;\n}\n\ninterface GeolocationLike {\n  getCurrentPosition(\n    success: () => void,\n    error: () => void,\n    options?: {\n      readonly maximumAge?: number;\n      readonly timeout?: number;\n    },\n  ): void;\n}\n\ninterface NavigatorLike {\n  readonly permissions?: BrowserPermissions;\n  readonly mediaDevices?: MediaDevicesLike;\n  readonly geolocation?: GeolocationLike;\n}\n\ninterface NotificationLike {\n  readonly permission: NotificationPermissionState;\n  requestPermission(): Promise<NotificationPermissionState> | NotificationPermissionState;\n}\n\ninterface WebGlobalLike {\n  readonly isSecureContext?: boolean;\n  readonly navigator?: NavigatorLike;\n  readonly Notification?: NotificationLike;\n}\n\n/***\n * Options for the browser permission adapter.\n */\nexport interface WebPermissionClientOptions {\n  readonly global?: WebGlobalLike;\n}\n\n/***\n * Creates a browser permission client using guarded structural globals.\n *\n * @readme\n * Unsupported web APIs resolve to `status: 'unavailable'`. The adapter does not\n * import DOM types and does not assume it is running in a browser.\n */\nexport function createWebPermissionClient(\n  options: WebPermissionClientOptions = {},\n): PermissionClient {\n  const global = options.global ?? getDefaultGlobal();\n\n  return {\n    async getStatus(permission) {\n      const knownPermission = assertKnownPermission(permission);\n\n      switch (knownPermission) {\n        case Permission.Notifications:\n          return getNotificationStatus(knownPermission, global);\n        case Permission.LocationForeground:\n          return getPermissionApiStatus(\n            knownPermission,\n            global,\n            'geolocation',\n            'Geolocation is unavailable in this environment.',\n          );\n        case Permission.Camera:\n          return getMediaStatus(knownPermission, global, 'camera');\n        case Permission.Microphone:\n          return getMediaStatus(knownPermission, global, 'microphone');\n        default:\n          return unavailable(\n            knownPermission,\n            'This permission is not supported by the web adapter.',\n          );\n      }\n    },\n\n    async request(permission) {\n      const knownPermission = assertKnownPermission(permission);\n\n      switch (knownPermission) {\n        case Permission.Notifications:\n          return requestNotifications(knownPermission, global);\n        case Permission.LocationForeground:\n          return requestGeolocation(knownPermission, global);\n        case Permission.Camera:\n          return requestMedia(knownPermission, global, { video: true });\n        case Permission.Microphone:\n          return requestMedia(knownPermission, global, { audio: true });\n        default:\n          return unavailable(\n            knownPermission,\n            'This permission is not supported by the web adapter.',\n          );\n      }\n    },\n  };\n}\n\nfunction getDefaultGlobal(): WebGlobalLike {\n  return globalThis as WebGlobalLike;\n}\n\nfunction getNotificationStatus(permission: Permission, global: WebGlobalLike): PermissionState {\n  if (global.Notification === undefined) {\n    return unavailable(permission, 'Notification API is unavailable.');\n  }\n\n  return stateFromNotificationPermission(permission, global.Notification.permission);\n}\n\nasync function requestNotifications(\n  permission: Permission,\n  global: WebGlobalLike,\n): Promise<PermissionState> {\n  if (global.Notification === undefined) {\n    return unavailable(permission, 'Notification API is unavailable.');\n  }\n\n  try {\n    const result = await global.Notification.requestPermission();\n\n    return stateFromNotificationPermission(permission, result);\n  } catch (error) {\n    return unavailable(\n      permission,\n      `Notification permission request failed${formatErrorName(error)}.`,\n    );\n  }\n}\n\nasync function getPermissionApiStatus(\n  permission: Permission,\n  global: WebGlobalLike,\n  name: BrowserPermissionName,\n  unavailableReason: string,\n): Promise<PermissionState> {\n  if (global.navigator?.permissions === undefined) {\n    return unavailable(permission, unavailableReason);\n  }\n\n  try {\n    const status = await global.navigator.permissions.query({ name });\n\n    return stateFromBrowserPermission(permission, status.state);\n  } catch {\n    return unavailable(permission, unavailableReason);\n  }\n}\n\nasync function getMediaStatus(\n  permission: Permission,\n  global: WebGlobalLike,\n  name: BrowserPermissionName,\n): Promise<PermissionState> {\n  if (global.navigator?.permissions !== undefined) {\n    try {\n      const status = await global.navigator.permissions.query({ name });\n\n      return stateFromBrowserPermission(permission, status.state);\n    } catch {\n      return getMediaAvailability(permission, global);\n    }\n  }\n\n  return getMediaAvailability(permission, global);\n}\n\nfunction getMediaAvailability(permission: Permission, global: WebGlobalLike): PermissionState {\n  if (global.isSecureContext === false) {\n    return createPermissionState({\n      permission,\n      status: 'blocked',\n      canAskAgain: false,\n      reason: 'Media permissions require a secure context.',\n    });\n  }\n\n  if (global.navigator?.mediaDevices?.getUserMedia === undefined) {\n    return unavailable(permission, 'Media devices API is unavailable.');\n  }\n\n  return createPermissionState({\n    permission,\n    status: 'unknown',\n    canAskAgain: true,\n  });\n}\n\nasync function requestGeolocation(\n  permission: Permission,\n  global: WebGlobalLike,\n): Promise<PermissionState> {\n  if (global.isSecureContext === false) {\n    return createPermissionState({\n      permission,\n      status: 'blocked',\n      canAskAgain: false,\n      reason: 'Geolocation requires a secure context.',\n    });\n  }\n\n  if (global.navigator?.geolocation === undefined) {\n    return unavailable(permission, 'Geolocation API is unavailable.');\n  }\n\n  return new Promise((resolve) => {\n    global.navigator?.geolocation?.getCurrentPosition(\n      () => {\n        resolve(\n          createPermissionState({\n            permission,\n            status: 'granted',\n            canAskAgain: true,\n            requestedAt: new Date(),\n          }),\n        );\n      },\n      () => {\n        resolve(\n          createPermissionState({\n            permission,\n            status: 'denied',\n            canAskAgain: false,\n            requestedAt: new Date(),\n          }),\n        );\n      },\n      { maximumAge: 0 },\n    );\n  });\n}\n\nasync function requestMedia(\n  permission: Permission,\n  global: WebGlobalLike,\n  constraints: {\n    readonly audio?: boolean;\n    readonly video?: boolean;\n  },\n): Promise<PermissionState> {\n  const availability = getMediaAvailability(permission, global);\n\n  if (availability.status !== 'unknown') {\n    return availability;\n  }\n\n  try {\n    const stream = await global.navigator?.mediaDevices?.getUserMedia(constraints);\n\n    for (const track of stream?.getTracks() ?? []) {\n      track.stop();\n    }\n\n    return createPermissionState({\n      permission,\n      status: 'granted',\n      canAskAgain: true,\n      requestedAt: new Date(),\n    });\n  } catch (error) {\n    return stateFromMediaError(permission, error);\n  }\n}\n\nfunction stateFromMediaError(permission: Permission, error: unknown): PermissionState {\n  const errorName = getErrorName(error);\n  const unavailableErrorNames = new Set([\n    'AbortError',\n    'NotFoundError',\n    'NotReadableError',\n    'OverconstrainedError',\n    'SecurityError',\n  ]);\n\n  if (errorName !== undefined && unavailableErrorNames.has(errorName)) {\n    return createPermissionState({\n      permission,\n      status: 'unavailable',\n      canAskAgain: false,\n      requestedAt: new Date(),\n      reason: `Media permission request failed: ${errorName}.`,\n    });\n  }\n\n  return createPermissionState({\n    permission,\n    status: 'denied',\n    canAskAgain: false,\n    requestedAt: new Date(),\n    reason:\n      errorName === undefined\n        ? 'Media permission request was denied.'\n        : `Media permission request was denied: ${errorName}.`,\n  });\n}\n\nfunction stateFromNotificationPermission(\n  permission: Permission,\n  status: NotificationPermissionState,\n): PermissionState {\n  if (status === 'granted') {\n    return createPermissionState({\n      permission,\n      status: 'granted',\n      canAskAgain: true,\n    });\n  }\n\n  if (status === 'denied') {\n    return createPermissionState({\n      permission,\n      status: 'denied',\n      canAskAgain: false,\n    });\n  }\n\n  return createPermissionState({\n    permission,\n    status: 'unknown',\n    canAskAgain: true,\n  });\n}\n\nfunction stateFromBrowserPermission(\n  permission: Permission,\n  status: BrowserPermissionState,\n): PermissionState {\n  const normalizedStatus: PermissionStatus = status === 'prompt' ? 'unknown' : status;\n\n  return createPermissionState({\n    permission,\n    status: normalizedStatus,\n    canAskAgain: status === 'prompt' || status === 'granted',\n  });\n}\n\nfunction unavailable(permission: Permission, reason: string): PermissionState {\n  return createPermissionState({\n    permission,\n    status: 'unavailable',\n    canAskAgain: false,\n    reason,\n  });\n}\n\nfunction formatErrorName(error: unknown): string {\n  const errorName = getErrorName(error);\n\n  return errorName === undefined ? '' : `: ${errorName}`;\n}\n\nfunction getErrorName(error: unknown): string | undefined {\n  if (typeof error !== 'object' || error === null || !('name' in error)) {\n    return undefined;\n  }\n\n  return typeof error.name === 'string' && error.name.length > 0 ? error.name : undefined;\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PermissionClient } from '../client/types';\nimport { assertKnownPermission, Permission } from '../registry/permissions';\nimport { createPermissionState, type PermissionState } from '../state/permissionState';\nimport {\n  type BrowserPermissionState,\n  formatErrorName,\n  type NotificationPermissionState,\n  stateFromBrowserPermission,\n  stateFromMediaError,\n  stateFromNotificationPermission,\n  unavailable,\n} from './permissionStates';\n\ntype BrowserPermissionName = 'camera' | 'microphone' | 'geolocation' | 'notifications';\ninterface BrowserPermissionStatus {\n  readonly state: BrowserPermissionState;\n}\n\ninterface BrowserPermissions {\n  query(descriptor: { readonly name: BrowserPermissionName }): Promise<BrowserPermissionStatus>;\n}\n\ninterface MediaStreamTrackLike {\n  stop(): void;\n}\n\ninterface MediaStreamLike {\n  getTracks(): readonly MediaStreamTrackLike[];\n}\n\ninterface MediaDevicesLike {\n  getUserMedia(constraints: {\n    readonly audio?: boolean;\n    readonly video?: boolean;\n  }): Promise<MediaStreamLike>;\n}\n\ninterface GeolocationLike {\n  getCurrentPosition(\n    success: () => void,\n    error: () => void,\n    options?: {\n      readonly maximumAge?: number;\n      readonly timeout?: number;\n    },\n  ): void;\n}\n\ninterface NavigatorLike {\n  readonly permissions?: BrowserPermissions;\n  readonly mediaDevices?: MediaDevicesLike;\n  readonly geolocation?: GeolocationLike;\n}\n\ninterface NotificationLike {\n  readonly permission: NotificationPermissionState;\n  requestPermission(): Promise<NotificationPermissionState> | NotificationPermissionState;\n}\n\ninterface WebGlobalLike {\n  readonly isSecureContext?: boolean;\n  readonly navigator?: NavigatorLike;\n  readonly Notification?: NotificationLike;\n}\n\n/***\n * Options for the browser permission adapter.\n */\nexport interface WebPermissionClientOptions {\n  readonly global?: WebGlobalLike;\n}\n\n/***\n * Creates a browser permission client using guarded structural globals.\n *\n * @readme\n * Unsupported web APIs resolve to `status: 'unavailable'`. The adapter does not\n * import DOM types and does not assume it is running in a browser.\n */\nexport function createWebPermissionClient(\n  options: WebPermissionClientOptions = {},\n): PermissionClient {\n  const global = options.global ?? getDefaultGlobal();\n\n  return {\n    async getStatus(permission) {\n      const knownPermission = assertKnownPermission(permission);\n\n      switch (knownPermission) {\n        case Permission.Notifications:\n          return getNotificationStatus(knownPermission, global);\n        case Permission.LocationForeground:\n          return getPermissionApiStatus(\n            knownPermission,\n            global,\n            'geolocation',\n            'Geolocation is unavailable in this environment.',\n          );\n        case Permission.Camera:\n          return getMediaStatus(knownPermission, global, 'camera');\n        case Permission.Microphone:\n          return getMediaStatus(knownPermission, global, 'microphone');\n        default:\n          return unavailable(\n            knownPermission,\n            'This permission is not supported by the web adapter.',\n          );\n      }\n    },\n\n    async request(permission) {\n      const knownPermission = assertKnownPermission(permission);\n\n      switch (knownPermission) {\n        case Permission.Notifications:\n          return requestNotifications(knownPermission, global);\n        case Permission.LocationForeground:\n          return requestGeolocation(knownPermission, global);\n        case Permission.Camera:\n          return requestMedia(knownPermission, global, { video: true });\n        case Permission.Microphone:\n          return requestMedia(knownPermission, global, { audio: true });\n        default:\n          return unavailable(\n            knownPermission,\n            'This permission is not supported by the web adapter.',\n          );\n      }\n    },\n  };\n}\n\nfunction getDefaultGlobal(): WebGlobalLike {\n  return globalThis as WebGlobalLike;\n}\n\nfunction getNotificationStatus(permission: Permission, global: WebGlobalLike): PermissionState {\n  if (global.Notification === undefined) {\n    return unavailable(permission, 'Notification API is unavailable.');\n  }\n\n  return stateFromNotificationPermission(permission, global.Notification.permission);\n}\n\nasync function requestNotifications(\n  permission: Permission,\n  global: WebGlobalLike,\n): Promise<PermissionState> {\n  if (global.Notification === undefined) {\n    return unavailable(permission, 'Notification API is unavailable.');\n  }\n\n  try {\n    const result = await global.Notification.requestPermission();\n\n    return stateFromNotificationPermission(permission, result);\n  } catch (error) {\n    return unavailable(\n      permission,\n      `Notification permission request failed${formatErrorName(error)}.`,\n    );\n  }\n}\n\nasync function getPermissionApiStatus(\n  permission: Permission,\n  global: WebGlobalLike,\n  name: BrowserPermissionName,\n  unavailableReason: string,\n): Promise<PermissionState> {\n  if (global.navigator?.permissions === undefined) {\n    return unavailable(permission, unavailableReason);\n  }\n\n  try {\n    const status = await global.navigator.permissions.query({ name });\n\n    return stateFromBrowserPermission(permission, status.state);\n  } catch {\n    return unavailable(permission, unavailableReason);\n  }\n}\n\nasync function getMediaStatus(\n  permission: Permission,\n  global: WebGlobalLike,\n  name: BrowserPermissionName,\n): Promise<PermissionState> {\n  if (global.navigator?.permissions !== undefined) {\n    try {\n      const status = await global.navigator.permissions.query({ name });\n\n      return stateFromBrowserPermission(permission, status.state);\n    } catch {\n      return getMediaAvailability(permission, global);\n    }\n  }\n\n  return getMediaAvailability(permission, global);\n}\n\nfunction getMediaAvailability(permission: Permission, global: WebGlobalLike): PermissionState {\n  if (global.isSecureContext === false) {\n    return createPermissionState({\n      permission,\n      status: 'blocked',\n      canAskAgain: false,\n      reason: 'Media permissions require a secure context.',\n    });\n  }\n\n  if (global.navigator?.mediaDevices?.getUserMedia === undefined) {\n    return unavailable(permission, 'Media devices API is unavailable.');\n  }\n\n  return createPermissionState({\n    permission,\n    status: 'unknown',\n    canAskAgain: true,\n  });\n}\n\nasync function requestGeolocation(\n  permission: Permission,\n  global: WebGlobalLike,\n): Promise<PermissionState> {\n  if (global.isSecureContext === false) {\n    return createPermissionState({\n      permission,\n      status: 'blocked',\n      canAskAgain: false,\n      reason: 'Geolocation requires a secure context.',\n    });\n  }\n\n  if (global.navigator?.geolocation === undefined) {\n    return unavailable(permission, 'Geolocation API is unavailable.');\n  }\n\n  return new Promise((resolve) => {\n    global.navigator?.geolocation?.getCurrentPosition(\n      () => {\n        resolve(\n          createPermissionState({\n            permission,\n            status: 'granted',\n            canAskAgain: true,\n            requestedAt: new Date(),\n          }),\n        );\n      },\n      () => {\n        resolve(\n          createPermissionState({\n            permission,\n            status: 'denied',\n            canAskAgain: false,\n            requestedAt: new Date(),\n          }),\n        );\n      },\n      { maximumAge: 0 },\n    );\n  });\n}\n\nasync function requestMedia(\n  permission: Permission,\n  global: WebGlobalLike,\n  constraints: {\n    readonly audio?: boolean;\n    readonly video?: boolean;\n  },\n): Promise<PermissionState> {\n  const availability = getMediaAvailability(permission, global);\n\n  if (availability.status !== 'unknown') {\n    return availability;\n  }\n\n  try {\n    const stream = await global.navigator?.mediaDevices?.getUserMedia(constraints);\n\n    for (const track of stream?.getTracks() ?? []) {\n      track.stop();\n    }\n\n    return createPermissionState({\n      permission,\n      status: 'granted',\n      canAskAgain: true,\n      requestedAt: new Date(),\n    });\n  } catch (error) {\n    return stateFromMediaError(permission, error);\n  }\n}\n"]}

package/dist/web/permissionStates.d.ts

@@ -0,0 +1,10 @@
+import type { Permission } from '../registry/permissions';
+import { type PermissionState } from '../state/permissionState';
+export type BrowserPermissionState = 'granted' | 'denied' | 'prompt';
+export type NotificationPermissionState = 'default' | 'denied' | 'granted';
+export declare function stateFromMediaError(permission: Permission, error: unknown): PermissionState;
+export declare function stateFromNotificationPermission(permission: Permission, status: NotificationPermissionState): PermissionState;
+export declare function stateFromBrowserPermission(permission: Permission, status: BrowserPermissionState): PermissionState;
+export declare function unavailable(permission: Permission, reason: string): PermissionState;
+export declare function formatErrorName(error: unknown): string;
+//# sourceMappingURL=permissionStates.d.ts.map

package/dist/web/permissionStates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissionStates.d.ts","sourceRoot":"","sources":["../../src/web/permissionStates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,0BAA0B,CAAC;AAElC,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACrE,MAAM,MAAM,2BAA2B,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE3E,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,eAAe,CA4B3F;AAED,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,2BAA2B,GAClC,eAAe,CAQjB;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,sBAAsB,GAC7B,eAAe,CAOjB;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAOnF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGtD"}

package/dist/web/permissionStates.js

@@ -0,0 +1,64 @@
+import { createPermissionState, } from '../state/permissionState';
+export function stateFromMediaError(permission, error) {
+    const errorName = getErrorName(error);
+    const unavailableErrorNames = new Set([
+        'AbortError',
+        'NotFoundError',
+        'NotReadableError',
+        'OverconstrainedError',
+        'SecurityError',
+    ]);
+    if (errorName !== undefined && unavailableErrorNames.has(errorName)) {
+        return createPermissionState({
+            permission,
+            status: 'unavailable',
+            canAskAgain: false,
+            requestedAt: new Date(),
+            reason: `Media permission request failed: ${errorName}.`,
+        });
+    }
+    return createPermissionState({
+        permission,
+        status: 'denied',
+        canAskAgain: false,
+        requestedAt: new Date(),
+        reason: errorName === undefined
+            ? 'Media permission request was denied.'
+            : `Media permission request was denied: ${errorName}.`,
+    });
+}
+export function stateFromNotificationPermission(permission, status) {
+    if (status === 'granted') {
+        return createPermissionState({ permission, status: 'granted', canAskAgain: true });
+    }
+    if (status === 'denied') {
+        return createPermissionState({ permission, status: 'denied', canAskAgain: false });
+    }
+    return createPermissionState({ permission, status: 'unknown', canAskAgain: true });
+}
+export function stateFromBrowserPermission(permission, status) {
+    const normalizedStatus = status === 'prompt' ? 'unknown' : status;
+    return createPermissionState({
+        permission,
+        status: normalizedStatus,
+        canAskAgain: status === 'prompt' || status === 'granted',
+    });
+}
+export function unavailable(permission, reason) {
+    return createPermissionState({
+        permission,
+        status: 'unavailable',
+        canAskAgain: false,
+        reason,
+    });
+}
+export function formatErrorName(error) {
+    const errorName = getErrorName(error);
+    return errorName === undefined ? '' : `: ${errorName}`;
+}
+function getErrorName(error) {
+    if (typeof error !== 'object' || error === null || !('name' in error))
+        return undefined;
+    return typeof error.name === 'string' && error.name.length > 0 ? error.name : undefined;
+}
+//# sourceMappingURL=permissionStates.js.map

package/dist/web/permissionStates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissionStates.js","sourceRoot":"","sources":["../../src/web/permissionStates.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,GAGtB,MAAM,0BAA0B,CAAC;AAKlC,MAAM,UAAU,mBAAmB,CAAC,UAAsB,EAAE,KAAc;IACxE,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;QACpC,YAAY;QACZ,eAAe;QACf,kBAAkB;QAClB,sBAAsB;QACtB,eAAe;KAChB,CAAC,CAAC;IACH,IAAI,SAAS,KAAK,SAAS,IAAI,qBAAqB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACpE,OAAO,qBAAqB,CAAC;YAC3B,UAAU;YACV,MAAM,EAAE,aAAa;YACrB,WAAW,EAAE,KAAK;YAClB,WAAW,EAAE,IAAI,IAAI,EAAE;YACvB,MAAM,EAAE,oCAAoC,SAAS,GAAG;SACzD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,qBAAqB,CAAC;QAC3B,UAAU;QACV,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,IAAI,IAAI,EAAE;QACvB,MAAM,EACJ,SAAS,KAAK,SAAS;YACrB,CAAC,CAAC,sCAAsC;YACxC,CAAC,CAAC,wCAAwC,SAAS,GAAG;KAC3D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,UAAsB,EACtB,MAAmC;IAEnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,qBAAqB,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,OAAO,qBAAqB,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,qBAAqB,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,UAAsB,EACtB,MAA8B;IAE9B,MAAM,gBAAgB,GAAqB,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;IACpF,OAAO,qBAAqB,CAAC;QAC3B,UAAU;QACV,MAAM,EAAE,gBAAgB;QACxB,WAAW,EAAE,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS;KACzD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAAsB,EAAE,MAAc;IAChE,OAAO,qBAAqB,CAAC;QAC3B,UAAU;QACV,MAAM,EAAE,aAAa;QACrB,WAAW,EAAE,KAAK;QAClB,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACtC,OAAO,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;AACzD,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACxF,OAAO,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1F,CAAC","sourcesContent":["import type { Permission } from '../registry/permissions';\nimport {\n  createPermissionState,\n  type PermissionState,\n  type PermissionStatus,\n} from '../state/permissionState';\n\nexport type BrowserPermissionState = 'granted' | 'denied' | 'prompt';\nexport type NotificationPermissionState = 'default' | 'denied' | 'granted';\n\nexport function stateFromMediaError(permission: Permission, error: unknown): PermissionState {\n  const errorName = getErrorName(error);\n  const unavailableErrorNames = new Set([\n    'AbortError',\n    'NotFoundError',\n    'NotReadableError',\n    'OverconstrainedError',\n    'SecurityError',\n  ]);\n  if (errorName !== undefined && unavailableErrorNames.has(errorName)) {\n    return createPermissionState({\n      permission,\n      status: 'unavailable',\n      canAskAgain: false,\n      requestedAt: new Date(),\n      reason: `Media permission request failed: ${errorName}.`,\n    });\n  }\n  return createPermissionState({\n    permission,\n    status: 'denied',\n    canAskAgain: false,\n    requestedAt: new Date(),\n    reason:\n      errorName === undefined\n        ? 'Media permission request was denied.'\n        : `Media permission request was denied: ${errorName}.`,\n  });\n}\n\nexport function stateFromNotificationPermission(\n  permission: Permission,\n  status: NotificationPermissionState,\n): PermissionState {\n  if (status === 'granted') {\n    return createPermissionState({ permission, status: 'granted', canAskAgain: true });\n  }\n  if (status === 'denied') {\n    return createPermissionState({ permission, status: 'denied', canAskAgain: false });\n  }\n  return createPermissionState({ permission, status: 'unknown', canAskAgain: true });\n}\n\nexport function stateFromBrowserPermission(\n  permission: Permission,\n  status: BrowserPermissionState,\n): PermissionState {\n  const normalizedStatus: PermissionStatus = status === 'prompt' ? 'unknown' : status;\n  return createPermissionState({\n    permission,\n    status: normalizedStatus,\n    canAskAgain: status === 'prompt' || status === 'granted',\n  });\n}\n\nexport function unavailable(permission: Permission, reason: string): PermissionState {\n  return createPermissionState({\n    permission,\n    status: 'unavailable',\n    canAskAgain: false,\n    reason,\n  });\n}\n\nexport function formatErrorName(error: unknown): string {\n  const errorName = getErrorName(error);\n  return errorName === undefined ? '' : `: ${errorName}`;\n}\n\nfunction getErrorName(error: unknown): string | undefined {\n  if (typeof error !== 'object' || error === null || !('name' in error)) return undefined;\n  return typeof error.name === 'string' && error.name.length > 0 ? error.name : undefined;\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/permissions",
   "type": "module",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Cross-platform permission registry and runtime helpers for Expo, React Native, and React Native Web apps, with unified request/check APIs for camera, media, location, notifications, microphone, and other web/native capabilities.",
   "homepage": "https://github.com/ankhorage/permissions#readme",
   "bugs": {
@@ -39,8 +39,13 @@
   },
   "ankh": {
     "category": "permissions",
-    "provider": null,
-    "capabilities": []
+    "provider": "./dist/cli/index.js",
+    "capabilities": [
+      "permissions.inspect",
+      "permissions.check",
+      "permissions.request",
+      "permissions.manifest"
+    ]
   },
   "files": [
     "dist",
@@ -58,6 +63,11 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./cli": {
+      "types": "./dist/cli/index.d.ts",
+      "import": "./dist/cli/index.js",
+      "default": "./dist/cli/index.js"
+    },
     "./react": {
       "react-native": "./dist/react/index.js",
       "browser": "./dist/react/index.js",
@@ -103,11 +113,10 @@
     "access": "public"
   },
   "scripts": {
-    "build": "rm -rf dist tsconfig.tsbuildinfo && bun x tsc -p tsconfig.json",
-    "changeset": "changeset",
-    "changeset:status": "changeset status --since=origin/main",
+    "build": "rm -rf dist tsconfig.tsbuildinfo tsconfig.build.tsbuildinfo && bun x tsc -p tsconfig.build.json",
+    "changeset": "ankhorage-changeset",
+    "changeset:status": "ankhorage-changeset status --since=origin/main",
     "docs": "paradox",
-    "knip": "ankhorage-knip",
     "lint": "ankhorage-eslint . --max-warnings=0",
     "lint:fix": "ankhorage-eslint . --fix --max-warnings=0",
     "format": "ankhorage-prettier --write .",
@@ -115,17 +124,17 @@
     "prepack": "bun run build",
     "test": "bun test src",
     "typecheck": "bun x tsc --noEmit -p tsconfig.json",
-    "version-packages": "changeset version"
+    "version-packages": "ankhorage-changeset version",
+    "knip:check": "ankhorage-knip"
   },
   "devDependencies": {
-    "@ankhorage/devtools": "^1.0.6",
-    "@ankhorage/paradox": "^0.1.10",
-    "@changesets/cli": "^2.31.0",
-    "@types/bun": "^1.3.13",
+    "@ankhorage/devtools": "^1.9.2",
+    "@ankhorage/paradox": "^0.1.24",
+    "@types/bun": "^1.4.0",
     "@types/node": "^25.6.0",
     "@types/react": "^19.2.7",
     "react": "^19.2.1",
     "typescript": "^5.9.3"
   },
-  "packageManager": "bun@1.3.13"
+  "packageManager": "bun@1.4.0"
 }

package/src/cli/index.ts

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

package/src/expo/adapters/mediaLibrary.ts

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

package/src/expo/adapters/notifications.ts

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

package/src/expo/client.notifications.test.ts

@@ -0,0 +1,106 @@
+import { beforeEach, expect, test } from 'bun:test';
+
+import { Permission } from '../registry/permissions';
+import { createPermissionClient } from './client';
+import {
+  audioMock,
+  cameraMock,
+  linkingMock,
+  type MockPermissionResponse,
+  notificationsMock,
+  resetExpoMocks,
+} from './client.testSupport';
+
+const IOS_AUTHORIZATION_CASES = [
+  [0, true, 'unknown', false, 'iOS notification authorization has not been determined.'],
+  [1, true, 'denied', false, 'iOS notification authorization is denied.'],
+  [1, false, 'blocked', false, 'Permission is blocked. Open system settings to change it.'],
+  [2, false, 'granted', true, undefined],
+  [3, false, 'limited', true, 'iOS notification authorization is provisional.'],
+  [4, false, 'limited', true, 'iOS notification authorization is ephemeral.'],
+] as const;
+
+beforeEach(resetExpoMocks);
+
+test('Expo client uses granular iOS notification authorization', async () => {
+  const client = createPermissionClient();
+  for (const [iosStatus, canAskAgain, status, granted, reason] of IOS_AUTHORIZATION_CASES) {
+    const response: MockPermissionResponse = {
+      status: iosStatus === 2 ? 'denied' : 'granted',
+      canAskAgain,
+      ios: { status: iosStatus },
+    };
+    notificationsMock.getResponse = response;
+    notificationsMock.requestResponse = response;
+    for (const state of [
+      await client.getStatus(Permission.Notifications),
+      await client.request(Permission.Notifications),
+    ]) {
+      expect(state).toMatchObject({
+        permission: Permission.Notifications,
+        status,
+        granted,
+        canAskAgain,
+        reason,
+      });
+    }
+  }
+});
+
+test('Expo client opens native application settings', async () => {
+  const client = createPermissionClient();
+  if (client.openSettings === undefined) throw new Error('Expected openSettings.');
+  await client.openSettings();
+  expect(linkingMock.calls).toBe(1);
+});
+
+test('Expo client preserves the native settings failure cause', async () => {
+  const cause = new Error('native settings unavailable');
+  linkingMock.error = cause;
+  const error = await captureOpenSettingsErrorAsync();
+  expect(error.message).toBe('Unable to open application settings.');
+  expect(error.cause).toBe(cause);
+});
+
+test('Expo client uses the stable settings error on web', async () => {
+  const cause = new Error('openSettings is unavailable on web');
+  cause.name = 'UnavailabilityError';
+  linkingMock.error = cause;
+  const error = await captureOpenSettingsErrorAsync();
+  expect(error.message).toBe('Unable to open application settings.');
+  expect(error.cause).toBe(cause);
+});
+
+test('Expo client returns unavailable when a camera call fails', async () => {
+  cameraMock.getError = 'camera bridge unavailable';
+  const state = await createPermissionClient().getStatus(Permission.Camera);
+  expect(state).toMatchObject({
+    permission: Permission.Camera,
+    status: 'unavailable',
+    granted: false,
+    reason: 'camera bridge unavailable',
+  });
+});
+
+test('Expo client returns unavailable when an audio request fails', async () => {
+  audioMock.requestError = 'microphone bridge unavailable';
+  const state = await createPermissionClient().request(Permission.Microphone);
+  expect(state).toMatchObject({
+    permission: Permission.Microphone,
+    status: 'unavailable',
+    granted: false,
+    reason: 'microphone bridge unavailable',
+  });
+});
+
+async function captureOpenSettingsErrorAsync(): Promise<Error> {
+  const client = createPermissionClient();
+  if (client.openSettings === undefined) throw new Error('Expected openSettings.');
+  try {
+    await client.openSettings();
+  } catch (error) {
+    if (error instanceof Error) return error;
+    throw new Error('Opening settings must reject with an Error.', { cause: error });
+  }
+  throw new Error('Opening settings must reject.');
+}