feat: implement askForContactsAccess

Author: codebytere

README.md

@@ -16,7 +16,7 @@ This native Node.js module allows you to manage an app's access to:
 
 ## `permissions.getAuthStatus(type)`
 
-* `type` - The type of system component to which you are requesting access. Can be one of 'contacts', 'full-disk-access', 'photos', 'reminders', or 'calendar'.
+* `type` String - The type of system component to which you are requesting access. Can be one of 'contacts', 'full-disk-access', 'photos', 'reminders', or 'calendar'.
 
 Returns `String` - Can be one of 'Not Determined', 'Denied', 'Authorized', or 'Restricted'.
 
@@ -29,3 +29,24 @@ Return Value Descriptions:
 * 'Authorized' - The application is authorized to access `type` data.
 
 **Note:** Access to 'contacts' will always return a status of 'Authorized' prior to macOS 10.13 High Sierra, as access to contacts was unilaterally allowed until that version.
+
+## `permissions.askForContactsAccess(callback)`
+
+* `callback` Function
+  * `error` String | null - An error in performing the request, if one occurred.
+  * `status` String - Whether or not the request succeeded or failed; can be 'authorized' or 'denied'.
+
+In your app, you should put the reason you're requesting to manipulate user's contacts database in your `Info.plist` like so:
+
+```
+<key>NSContactsUsageDescription</key>
+<string>Your reason for wanting to access the Contact store</string>
+```
+
+```js
+const { askForContactsAccess } = require('node-mac-permissions')
+
+askForContactsAccess((err, status) => {
+  console.log(`Access to Contacts was ${status}`)
+})
+```

index.js

@@ -10,5 +10,6 @@ function getAuthStatus(type) {
 } 
 
 module.exports = {
-  getAuthStatus
+  getAuthStatus,
+  askForContactsAccess: permissions.askForContactsAccess
 }

permissions.mm

@@ -42,7 +42,7 @@
   return auth_status;
 }
 
-// Returns a status indicating whether or not the user has authorized Calendar access
+// Returns a status indicating whether or not the user has authorized Calendar/Reminders access
 std::string EventAuthStatus(std::string type) {
   std::string auth_status = "Not Determined";
 
@@ -125,11 +125,34 @@
   return Napi::Value::From(env, auth_status);
 }
 
+// Request access to the Contacts store.
+void AskForContactsAccess(const Napi::CallbackInfo &info) {
+  Napi::Env env = info.Env();
+  Napi::ThreadSafeFunction ts_fn = Napi::ThreadSafeFunction::New(env, info[0].As<Napi::Function>(),
+                                                                "Resource Name", 0, 1, [](Napi::Env){});
+
+  if (@available(macOS 10.11, *)) {
+    CNContactStore *store = [CNContactStore new];
+    [store requestAccessForEntityType:CNEntityTypeContacts completionHandler:^(BOOL granted, NSError* error) {
+      auto callback = [](Napi::Env env, Napi::Function js_cb, const char* granted) {
+        js_cb.Call({Napi::String::New(env, granted)});
+      };
+      ts_fn.BlockingCall(granted ? "authorized" : "denied", callback);
+    }];
+  } else {
+    Napi::FunctionReference fn = Napi::Persistent(info[0].As<Napi::Function>());
+    fn.Call({Napi::String::New(env, "authorized")});
+  }
+}
+
 // Initializes all functions exposed to JS
 Napi::Object Init(Napi::Env env, Napi::Object exports) {
   exports.Set(
     Napi::String::New(env, "getAuthStatus"), Napi::Function::New(env, GetAuthStatus)
   );
+  exports.Set(
+    Napi::String::New(env, "askForContactsAccess"), Napi::Function::New(env, AskForContactsAccess)
+  );
 
   return exports;
 }