feat: implement permissions.askForScreenCaptureAccess()

Author: codebytere

README.md

@@ -39,6 +39,7 @@ Return Value Descriptions:
 **Notes:**
   * Access to `contacts` will always return a status of `authorized` prior to macOS 10.11, as access to contacts was unilaterally allowed until that version.
   * Access to `camera` and `microphone` will always return a status of `authorized` prior to macOS 10.14, as access to contacts was unilaterally allowed until that version.
+  * Access to `screen` will always return a status of `authorized` prior to macOS 10.15, as access to screen capture was unilaterally allowed until that version.
 
 Example:
 ```js
@@ -146,3 +147,13 @@ for (const type of ['microphone', 'camera']) {
   })
 }
 ```
+## `permissions.askForScreenCaptureAccess()`
+
+There is no API for programmatically requesting Screen Capture on macOS at this time, and so calling this method will trigger opening of System Preferences at the Screen Capture pane of Security and Privacy.
+
+Example:
+```js
+const { askForScreenCaptureAccess } = require('node-mac-permissions')
+
+askForScreenCaptureAccess()
+```

permissions.mm

@@ -101,7 +101,7 @@
 }
 
 // Returns a status indicating whether the user has authorized
-// Screen Recording access
+// Screen Capture access
 std::string ScreenAuthStatus() {
   std::string auth_status = "not determined";
 
@@ -310,6 +310,16 @@ void AskForFullDiskAccess(const Napi::CallbackInfo &info) {
   return deferred.Promise();
 }
 
+// Request Screen Capture Access.
+void AskForScreenCaptureAccess(const Napi::CallbackInfo &info) {
+  if (@available(macOS 10.14, *)) {
+    NSWorkspace *workspace = [[NSWorkspace alloc] init];
+    NSString *pref_string = @"x-apple.systempreferences:com.apple.preference."
+                            @"security?Privacy_ScreenCapture";
+    [workspace openURL:[NSURL URLWithString:pref_string]];
+  }
+}
+
 // Initializes all functions exposed to JS
 Napi::Object Init(Napi::Env env, Napi::Object exports) {
   exports.Set(Napi::String::New(env, "getAuthStatus"),
@@ -324,6 +334,8 @@ void AskForFullDiskAccess(const Napi::CallbackInfo &info) {
               Napi::Function::New(env, AskForFullDiskAccess));
   exports.Set(Napi::String::New(env, "askForMediaAccess"),
               Napi::Function::New(env, AskForMediaAccess));
+  exports.Set(Napi::String::New(env, "askForScreenCaptureAccess"),
+            Napi::Function::New(env, AskForScreenCaptureAccess));
 
   return exports;
 }