[Feature Request] Add Delete User Capability #1554

Author: EddyVerbruggen

docs/AUTHENTICATION.md

@@ -1,7 +1,7 @@
 <img src="https://raw.githubusercontent.com/EddyVerbruggen/nativescript-plugin-firebase/master/docs/images/features/auth.png" height="85px" alt="Authentication"/>
 
 ## Enabling Authentication
-You can sign in a user either
+You can sign in a user, using either
 
 * [anonymously](#anonymous-login),
 * by [email and password](#email-password-login),
@@ -199,6 +199,20 @@ The logged in user will be updated, but for `getCurrentUser` to reflect the chan
   );
 ```
 
+### Deleting a user
+The currently logged in user will be deleted (the one returned by `getCurrentUser`).
+
+```js
+  firebase.deleteUser().then(
+      function () {
+        // called when the user was successfully deleted
+      },
+      function (errorMessage) {
+        console.log(errorMessage);
+      }
+  );
+```
+
 ### Anonymous login
 Don't forget to enable anonymous login in your firebase instance.