Update permissions request parameter names and docs (#7636)

The parameter names and JSDoc comments for `approvePermissionsRequest`
and `rejectPermissionsRequest` were incorrect in a few places.

app/scripts/controllers/permissions/index.js

@@ -133,7 +133,8 @@ class PermissionsController {
   /**
    * User approval callback. The request can fail if the request is invalid.
    *
-   * @param {object} approved the approved request object
+   * @param {object} approved - the approved request object
+   * @param {Array} accounts - The accounts to expose, if any
    */
   async approvePermissionsRequest (approved, accounts) {
 

ui/app/pages/permissions-connect/permissions-connect.component.js

@@ -186,8 +186,8 @@ export default class PermissionConnect extends Component {
             <div>
               <PermissionPageContainer
                 request={permissionsRequest || {}}
-                approvePermissionsRequest={ (requestId, accounts) => {
+                approvePermissionsRequest={(request, accounts) => {
-                  approvePermissionsRequest(requestId, accounts)
+                  approvePermissionsRequest(request, accounts)
                   this.redirectFlow(true)
                 }}
                 rejectPermissionsRequest={requestId => {

ui/app/pages/permissions-connect/permissions-connect.container.js

@@ -46,7 +46,7 @@ const mapStateToProps = state => {
 
 const mapDispatchToProps = dispatch => {
   return {
-    approvePermissionsRequest: (requestId, accounts) => dispatch(approvePermissionsRequest(requestId, accounts)),
+    approvePermissionsRequest: (request, accounts) => dispatch(approvePermissionsRequest(request, accounts)),
     rejectPermissionsRequest: requestId => dispatch(rejectPermissionsRequest(requestId)),
     showNewAccountModal: ({ onCreateNewAccount, newAccountNumber }) => {
       return dispatch(showModal({

ui/app/store/actions.js

@@ -2718,19 +2718,19 @@ function setPendingTokens (pendingTokens) {
 // Permissions
 
 /**
- * Approves the permission requests with the given IDs.
+ * Approves the permissions request.
- * @param {string} requestId - The id of the permissions request.
+ * @param {Object} request - The permissions request to approve
  * @param {string[]} accounts - The accounts to expose, if any.
  */
-function approvePermissionsRequest (requestId, accounts) {
+function approvePermissionsRequest (request, accounts) {
   return () => {
-    background.approvePermissionsRequest(requestId, accounts)
+    background.approvePermissionsRequest(request, accounts)
   }
 }
 
 /**
- * Rejects the permission requests with the given IDs.
+ * Rejects the permissions request with the given ID.
- * @param {Array} requestId
+ * @param {string} requestId - The id of the request to be rejected
  */
 function rejectPermissionsRequest (requestId) {
   return () => {