docs(all): standardizes and adds return types, also some param fixes

src/plugins/facebook.ts

@@ -90,6 +90,7 @@ export class Facebook {
    * Browser wrapper
    * @param {number} appId Your Facebook AppID from their dashboard
    * @param {string} version The version of API you may want to use. Optional
+   * @returns {Promise<any>}
    */
   @Cordova()
   static browserInit(appId: number, version?: string): Promise<any> {
@@ -114,7 +115,7 @@ export class Facebook {
    * ```
    *
    * @param {string[]}  permissions List of [permissions](https://developers.facebook.com/docs/facebook-login/permissions) this app has upon logging in.
-   * @return {Promise<FacebookLoginResponse>} Returns a Promise that resolves with a status object if login succeeds, and rejects if login fails.
+   * @returns {Promise<FacebookLoginResponse>} Returns a Promise that resolves with a status object if login succeeds, and rejects if login fails.
    */
   @Cordova()
   static login(permissions: string[]): Promise<FacebookLoginResponse> { return; }
@@ -123,7 +124,7 @@ export class Facebook {
    * Logout of Facebook.
    *
    * For more info see the [Facebook docs](https://developers.facebook.com/docs/reference/javascript/FB.logout)
-   * @return Returns a Promise that resolves on a successful logout, and rejects if logout fails.
+   * @returns {Promise<any>} Returns a Promise that resolves on a successful logout, and rejects if logout fails.
    */
   @Cordova()
   static logout(): Promise<any> { return; }
@@ -152,7 +153,7 @@ export class Facebook {
    *
    * For more information see the [Facebook docs](https://developers.facebook.com/docs/reference/javascript/FB.getLoginStatus)
    *
-   * @return Returns a Promise that resolves with a status, or rejects with an error
+   * @returns {Promise<any>} Returns a Promise that resolves with a status, or rejects with an error
    */
   @Cordova()
   static getLoginStatus(): Promise<any> { return; }
@@ -160,7 +161,7 @@ export class Facebook {
   /**
    * Get a Facebook access token for using Facebook services.
    *
-   * @return Returns a Promise that resolves with an access token, or rejects with an error
+   * @returns {Promise<string>} Returns a Promise that resolves with an access token, or rejects with an error
    */
   @Cordova()
   static getAccessToken(): Promise<string> { return; }
@@ -179,8 +180,8 @@ export class Facebook {
    * ```
    *
    * For more options see the [Cordova plugin docs](https://github.com/jeduan/cordova-plugin-facebook4#show-a-dialog) and the [Facebook docs](https://developers.facebook.com/docs/javascript/reference/FB.ui)
-   * @options {Object}  options The dialog options
-   * @return Returns a Promise that resolves with success data, or rejects with an error
+   * @param {Object} options The dialog options
+   * @returns {Promise<any>} Returns a Promise that resolves with success data, or rejects with an error
    */
   @Cordova()
   static showDialog(options: any): Promise<any> { return; }
@@ -196,7 +197,7 @@ export class Facebook {
    *
    * @param {string}  requestPath Graph API endpoint you want to call
    * @param {string[]}  permissions List of [permissions](https://developers.facebook.com/docs/facebook-login/permissions) for this request.
-   * @return Returns a Promise that resolves with the result of the request, or rejects with an error
+   * @returns {Promise<any>} Returns a Promise that resolves with the result of the request, or rejects with an error
    */
   @Cordova()
   static api(requestPath: string, permissions: string[]): Promise<any> { return; }
@@ -207,7 +208,7 @@ export class Facebook {
    * @param {string}  name Name of the event
    * @param {Object}  [params] An object containing extra data to log with the event
    * @param {number}  [valueToSum] any value to be added to added to a sum on each event
-   * @return
+   * @returns {Promise<any>}
    */
   @Cordova()
   static logEvent(
@@ -221,7 +222,7 @@ export class Facebook {
    *
    * @param {number}  value Value of the purchase.
    * @param {string}  currency The currency, as an [ISO 4217 currency code](http://en.wikipedia.org/wiki/ISO_4217)
-   * @return Returns a Promise
+   * @returns {Promise<any>}
    */
   @Cordova()
   static logPurchase(value: number, currency: string): Promise<any> { return; }
@@ -239,7 +240,7 @@ export class Facebook {
    *   url: [App Link](https://developers.facebook.com/docs/applinks) to your app
    *   picture: image to be displayed in the App Invite dialog
    *
-   * @return Returns a Promise that resolves with the result data, or rejects with an error
+   * @returns {Promise<any>} Returns a Promise that resolves with the result data, or rejects with an error
    */
   @Cordova()
   static appInvite(options: {