feat: add Focus Status permission support

Add support for checking and requesting Focus Status (Do Not Disturb)
authorization via INFocusStatusCenter, available since macOS 12.0.

New API:
- getAuthStatus('focus-status') - check current authorization
- askForFocusStatusAccess() - request authorization

Author: codebytere

README.md

@@ -14,6 +14,7 @@
   - [`permissions.askForCalendarAccess([accessLevel])`](#permissionsaskforcalendaraccessaccesslevel)
   - [`permissions.askForSpeechRecognitionAccess()`](#permissionsaskforspeechrecognitionaccess)
   - [`permissions.askForRemindersAccess()`](#permissionsaskforremindersaccess)
+  - [`permissions.askForFocusStatusAccess()`](#permissionsaskforfocusstatusaccess)
   - [`permissions.askForFoldersAccess(folder)`](#permissionsaskforfoldersaccessfolder)
   - [`permissions.askForFullDiskAccess()`](#permissionsaskforfulldiskaccess)
   - [`permissions.askForCameraAccess()`](#permissionsaskforcameraaccess)
@@ -38,6 +39,7 @@ This native Node.js module allows you to manage an app's access to:
 - Calendar
 - Camera
 - Contacts
+- Focus Status
 - Full Disk Access
 - Input Monitoring
 - Location
@@ -60,7 +62,7 @@ If you're using macOS 12.3 or newer, you'll need to ensure you have Python insta
 
 ### `permissions.getAuthStatus(type)`
 
-- `type` String - The type of system component to which you are requesting access. Can be one of `accessibility`, `bluetooth`, `calendar`, `camera`, `contacts`, `full-disk-access`, `input-monitoring`, `location`, `microphone`,`notifications`, `photos`, `reminders`, `screen`, or `speech-recognition`.
+- `type` String - The type of system component to which you are requesting access. Can be one of `accessibility`, `bluetooth`, `calendar`, `camera`, `contacts`, `focus-status`, `full-disk-access`, `input-monitoring`, `location`, `microphone`, `notifications`, `photos`, `reminders`, `screen`, or `speech-recognition`.
 
 Returns `String` - Can be one of `not determined`, `denied`, `authorized`, `limited`, `provisional`, or `restricted`.
 
@@ -84,6 +86,7 @@ const types = [
   'calendar',
   'camera',
   'contacts',
+  'focus-status',
   'full-disk-access',
   'input-monitoring',
   'location',
@@ -237,6 +240,28 @@ requesting Reminders access.
 <string>Your reason for wanting access to read and write Reminders data.</string>
 ```
 
+### `permissions.askForFocusStatusAccess()`
+
+Returns `Promise<String>` - Whether or not the request succeeded or failed; can be `authorized`, `denied`, `restricted`, or `not determined`.
+
+Checks the authorization status for Focus Status access. If the status check returns:
+
+- `not determined` - The Focus Status access authorization will prompt the user to authorize or deny. The Promise is resolved after the user selection.
+- `denied` - The Promise is resolved as `denied`.
+- `restricted` - The Promise is resolved as `restricted`.
+
+**Note:** Requires macOS 12.0 or higher. On older versions, the Promise resolves as `not determined`.
+
+Example:
+
+```js
+const { askForFocusStatusAccess } = require('node-mac-permissions')
+
+askForFocusStatusAccess().then(status => {
+  console.log(`Access to Focus Status is ${status}`)
+})
+```
+
 ### `permissions.askForFoldersAccess(folder)`
 
 - `type` String - The folder to which you are requesting access. Can be one of `desktop`, `documents`, or `downloads`.

binding.gyp

@@ -29,6 +29,7 @@
         "-framework CoreGraphics",
         "-framework Contacts",
         "-framework EventKit",
+        "-framework Intents",
         "-framework IOKit",
         "-framework Photos",
         "-framework Speech",

index.d.ts

@@ -6,6 +6,7 @@ export function askForAccessibilityAccess(): undefined
 export function askForCalendarAccess(accessType?: 'write-only' | 'full'): Promise<Omit<PermissionType, 'restricted'>>
 export function askForCameraAccess(): Promise<PermissionType>
 export function askForContactsAccess(): Promise<Omit<PermissionType, 'restricted'>>
+export function askForFocusStatusAccess(): Promise<PermissionType>
 export function askForFoldersAccess(): Promise<Omit<PermissionType, 'restricted'>>
 export function askForFullDiskAccess(): undefined
 export function askForInputMonitoringAccess(accessType?: 'listen' | 'post'): Promise<Omit<PermissionType, 'restricted'>>
@@ -23,6 +24,7 @@ export type AuthType =
   | 'calendar'
   | 'camera'
   | 'contacts'
+  | 'focus-status'
   | 'full-disk-access'
   | 'input-monitoring'
   | 'location'

index.js

@@ -8,6 +8,7 @@ function getAuthStatus(type) {
     'calendar',
     'camera',
     'contacts',
+    'focus-status',
     'full-disk-access',
     'input-monitoring',
     'location',
@@ -97,6 +98,7 @@ module.exports = {
   askForLocationAccess: askForLocationAccess,
   askForCameraAccess: permissions.askForCameraAccess,
   askForContactsAccess: permissions.askForContactsAccess,
+  askForFocusStatusAccess: permissions.askForFocusStatusAccess,
   askForFoldersAccess,
   askForFullDiskAccess: permissions.askForFullDiskAccess,
   askForInputMonitoringAccess,

permissions.mm

@@ -10,6 +10,7 @@
 #import <EventKit/EventKit.h>
 #import <Foundation/Foundation.h>
 #import <IOKit/hidsystem/IOHIDLib.h>
+#import <Intents/INFocusStatusCenter.h>
 #import <Photos/Photos.h>
 #import <Speech/Speech.h>
 #import <StoreKit/StoreKit.h>
@@ -402,6 +403,25 @@ bool HasOpenSystemPreferencesDialog() {
   return StringFromPhotosStatus(status);
 }
 
+// Returns a status indicating whether the user has authorized Focus Status
+// access.
+std::string FocusStatusAuthStatus() {
+  if (@available(macOS 12.0, *)) {
+    switch ([INFocusStatusCenter defaultCenter].authorizationStatus) {
+    case INFocusStatusAuthorizationStatusAuthorized:
+      return kAuthorized;
+    case INFocusStatusAuthorizationStatusDenied:
+      return kDenied;
+    case INFocusStatusAuthorizationStatusRestricted:
+      return kRestricted;
+    default:
+      return kNotDetermined;
+    }
+  }
+
+  return kNotDetermined;
+}
+
 /***** EXPORTED FUNCTIONS *****/
 
 // Returns the user's access consent status as a string.
@@ -442,6 +462,8 @@ bool HasOpenSystemPreferencesDialog() {
     auth_status = InputMonitoringAuthStatus();
   } else if (type == "notifications") {
     auth_status = NotificationAuthStatus();
+  } else if (type == "focus-status") {
+    auth_status = FocusStatusAuthStatus();
   }
 
   return Napi::Value::From(env, auth_status);
@@ -815,6 +837,55 @@ void AskForAccessibilityAccess(const Napi::CallbackInfo &info) {
   }
 }
 
+// Request Focus Status access.
+Napi::Promise AskForFocusStatusAccess(const Napi::CallbackInfo &info) {
+  Napi::Env env = info.Env();
+  Napi::Promise::Deferred deferred = Napi::Promise::Deferred::New(env);
+
+  if (@available(macOS 12.0, *)) {
+    Napi::ThreadSafeFunction tsfn = Napi::ThreadSafeFunction::New(
+        env, Napi::Function::New(env, NoOp), "focusStatusCallback", 0, 1);
+
+    auto callback = [=](Napi::Env env, Napi::Function js_cb,
+                        const char *status) {
+      deferred.Resolve(Napi::String::New(env, status));
+    };
+
+    std::string auth_status = FocusStatusAuthStatus();
+
+    if (auth_status == kNotDetermined) {
+      [[INFocusStatusCenter defaultCenter]
+          requestAuthorizationWithCompletionHandler:^(
+              INFocusStatusAuthorizationStatus status) {
+            const char *result;
+            switch (status) {
+            case INFocusStatusAuthorizationStatusAuthorized:
+              result = "authorized";
+              break;
+            case INFocusStatusAuthorizationStatusDenied:
+              result = "denied";
+              break;
+            case INFocusStatusAuthorizationStatusRestricted:
+              result = "restricted";
+              break;
+            default:
+              result = "not determined";
+              break;
+            }
+            tsfn.BlockingCall(result, callback);
+            tsfn.Release();
+          }];
+    } else {
+      tsfn.Release();
+      deferred.Resolve(Napi::String::New(env, auth_status));
+    }
+  } else {
+    deferred.Resolve(Napi::String::New(env, kNotDetermined));
+  }
+
+  return deferred.Promise();
+}
+
 // Initializes all functions exposed to JS
 Napi::Object Init(Napi::Env env, Napi::Object exports) {
   exports.Set(Napi::String::New(env, "askForAccessibilityAccess"),
@@ -827,6 +898,8 @@ void AskForAccessibilityAccess(const Napi::CallbackInfo &info) {
               Napi::Function::New(env, AskForCameraAccess));
   exports.Set(Napi::String::New(env, "askForContactsAccess"),
               Napi::Function::New(env, AskForContactsAccess));
+  exports.Set(Napi::String::New(env, "askForFocusStatusAccess"),
+              Napi::Function::New(env, AskForFocusStatusAccess));
   exports.Set(Napi::String::New(env, "askForFoldersAccess"),
               Napi::Function::New(env, AskForFoldersAccess));
   exports.Set(Napi::String::New(env, "askForFullDiskAccess"),

test/module.spec.js

@@ -24,6 +24,7 @@ describe('node-mac-permissions', () => {
         'calendar',
         'camera',
         'contacts',
+        'focus-status',
         'full-disk-access',
         'input-monitoring',
         'location',