RC of version 2.12.0

### Changed
- The SDK now supports version 19.2.02 of the DocuSign eSignature v2 API.
- SDK Release Version updated.
## Fixed
- Issue [`#55`](#55): Unable to revoke OAuth token. (DCM-2926)
- requestJWTUserToken does not give error response in exception. (DCM-3410)

Author: mmallis87

CHANGELOG.md

@@ -1,6 +1,14 @@
 # DocuSign Java Client Changelog
 See [DocuSign Support Center](https://support.docusign.com/en/releasenotes/) for Product Release Notes.
 
+## [v2.12.0-RC1] - eSignature API v2-19.2.02 - 2019-08-29
+### Changed
+- The SDK now supports version 19.2.02 of the DocuSign eSignature v2 API.
+- SDK Release Version updated.
+## Fixed
+- Issue [`#55`](https://github.com/docusign/docusign-java-client/issues/55): Unable to revoke OAuth token. (DCM-2926)
+- requestJWTUserToken does not give error response in exception. (DCM-3410)
+
 ## [v2.11.0] Full support of the Bulk Send API - 2019-06-26
 ## Fixed
 - Issue [`#98`](https://github.com/docusign/docusign-java-client/issues/98): 411 Error thrown from BulkEnvelopesAPI updateRecipients call.
@@ -13,39 +21,39 @@ See [DocuSign Support Center](https://support.docusign.com/en/releasenotes/) for
 
 ## [v2.10.0] - eSignature API v19.1.02 - 2019-05-16
 ### Changed
-* The SDK now supports version 19.1.02 of the DocuSign eSignature API.
-* SDK Release Version updated.
+- The SDK now supports version 19.1.02 of the DocuSign eSignature API.
+- SDK Release Version updated.
 ### Added
-* Added support for the new http.nonProxyHosts Proxy option, which you can use to indicate hosts that should be accessed without going through a proxy.  (DCM-2850)
-* Added new Cache-Control and Pragma headers to OAuth server request calls. (DCM-2242)
-* Added a new *tabGroupLabels* field to all Tabs models
-* Added a new *Witnesses* field to all Recipients models
-* Implemented models for Smart Sections feature
-* Implemented initial support of HMAC for DocuSign Connect
+- Added support for the new http.nonProxyHosts Proxy option, which you can use to indicate hosts that should be accessed without going through a proxy.  (DCM-2850)
+- Added new Cache-Control and Pragma headers to OAuth server request calls. (DCM-2242)
+- Added a new *tabGroupLabels* field to all Tabs models
+- Added a new *Witnesses* field to all Recipients models
+- Implemented models for Smart Sections feature
+- Implemented initial support of HMAC for DocuSign Connect
 ### Fixed
-* A bug with that could cause the *moveEnvelopes* method call to return a response without a *Content-Type* header. (DCM-1403)
-* A bug that could prevent a user from replacing their JWT auth token. (DCM-3209)
-* Removed Gradle references to an insecure/outdated Jackson package. (DCM-3267)
+- A bug with that could cause the *moveEnvelopes* method call to return a response without a *Content-Type* header. (DCM-1403)
+- A bug that could prevent a user from replacing their JWT auth token. (DCM-3209)
+- Removed Gradle references to an insecure/outdated Jackson package. (DCM-3267)
 
 ## [v2.10.0-RC2] - eSignature API v19.1.02 - 2019-05-09
 ### Fixed
-* A regression bug where the ApiClient authentications member field was locked and prevented writing to it.
+- A regression bug where the ApiClient authentications member field was locked and prevented writing to it.
 
 ## [v2.10.0-RC1] - eSignature API v19.1.02 - 2019-05-03
 ### Changed
-* The SDK now supports version 19.1.02 of the DocuSign eSignature API.
-* SDK Release Version updated.
+- The SDK now supports version 19.1.02 of the DocuSign eSignature API.
+- SDK Release Version updated.
 ### Added
-* Added support for the new http.nonProxyHosts Proxy option, which you can use to indicate hosts that should be accessed without going through a proxy.  (DCM-2850)
-* Added new Cache-Control and Pragma headers to OAuth server request calls. (DCM-2242)
-* Added a new *tabGroupLabels* field to all Tabs models
-* Added a new *Witnesses* field to all Recipients models
-* Implemented models for Smart Sections feature
-* Implemented initial support of HMAC for DocuSign Connect
+- Added support for the new http.nonProxyHosts Proxy option, which you can use to indicate hosts that should be accessed without going through a proxy.  (DCM-2850)
+- Added new Cache-Control and Pragma headers to OAuth server request calls. (DCM-2242)
+- Added a new *tabGroupLabels* field to all Tabs models
+- Added a new *Witnesses* field to all Recipients models
+- Implemented models for Smart Sections feature
+- Implemented initial support of HMAC for DocuSign Connect
 ### Fixed
-* A bug with that could cause the *moveEnvelopes* method call to return a response without a *Content-Type* header. (DCM-1403)
-* A bug that could prevent a user from replacing their JWT auth token. (DCM-3209)
-* Removed Gradle references to an insecure/outdated Jackson package. (DCM-3267)
+- A bug with that could cause the *moveEnvelopes* method call to return a response without a *Content-Type* header. (DCM-1403)
+- A bug that could prevent a user from replacing their JWT auth token. (DCM-3209)
+- Removed Gradle references to an insecure/outdated Jackson package. (DCM-3267)
 
 ## [v2.9.0] - eSignature API v18.4.02 - 2019-02-27
 ### Added

README.md

@@ -34,7 +34,7 @@ Note: DocuSign uses **Eclipse** with **Maven** for testing purposes.
 <dependency>
   <groupId>com.docusign</groupId>
   <artifactId>docusign-esign-java</artifactId>
-  <version>2.11.0</version>
+  <version>v2.12.0-RC1</version>
 </dependency>
 ```
 

build.gradle

@@ -2,7 +2,7 @@ apply plugin: 'idea'
 apply plugin: 'eclipse'
 
 group = 'com.docusign'
-version = '2.11.0'
+version = 'v2.12.0-RC1'
 
 buildscript {
     repositories {

pom.xml

@@ -4,7 +4,7 @@
   <artifactId>docusign-esign-java</artifactId>
   <packaging>jar</packaging>
   <name>docusign-esign-java</name>
-  <version>2.11.0</version>
+  <version>v2.12.0-RC1</version>
   <description>The official DocuSign eSignature JAVA client is based on version 2 of the DocuSign REST API and provides libraries for JAVA application integration. It is recommended that you use this version of the library for new development.</description>
   <url>https://www.docusign.com/developer-center</url>
 
@@ -283,7 +283,7 @@
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     <swagger-annotations-version>1.5.8</swagger-annotations-version>
     <jersey-version>1.19.1</jersey-version>
-    <jackson-version>2.9.9</jackson-version>
+    <jackson-version>2.10.0.pr1</jackson-version>
     <jodatime-version>2.9.3</jodatime-version>
     <maven-plugin-version>1.0.0</maven-plugin-version>
     <junit-version>4.12</junit-version>

src/main/java/com/docusign/esign/api/AuthenticationApi.java

@@ -274,13 +274,42 @@ public LoginInformation login(AuthenticationApi.LoginOptions options) throws Api
         return apiClient.invokeAPI(localVarPath, "GET", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
           }
 
-  /**
+  /// <summary>
+  ///  Options object including the token to be revoked
+  /// </summary>
+  public class RevokeOAuthTokenOptions
+  {
+  private String token = null;
+  /*
+   * The token to be revoked. 
+   */
+  public void setToken(String token) {
+    this.token = token;
+  }
+  
+  public String getToken() {
+    return this.token;
+  }
+  }
+
+   /**
    * Revokes an authorization token.
    * Revokes an OAuth2 authorization server token. After the revocation is complete, a caller must re-authenticate to restore access.
    * @throws ApiException if fails to make API call
    */
   public void revokeOAuthToken() throws ApiException {
-    Object localVarPostBody = "{}";
+	  revokeOAuthToken(null);
+  }
+  
+  
+   /**
+   * Revokes an authorization token.
+   * Revokes an OAuth2 authorization server token. After the revocation is complete, a caller must re-authenticate to restore access.
+   * @param options for modifying the method behavior.
+   * @throws ApiException if fails to make API call
+   */
+  public void revokeOAuthToken(AuthenticationApi.RevokeOAuthTokenOptions options) throws ApiException {
+    Object localVarPostBody = null;
 
     // create path and map variables
     String localVarPath = "/v2/oauth2/revoke".replaceAll("\\{format\\}","json");
@@ -290,16 +319,18 @@ public void revokeOAuthToken() throws ApiException {
     java.util.Map<String, String> localVarHeaderParams = new java.util.HashMap<String, String>();
     java.util.Map<String, Object> localVarFormParams = new java.util.HashMap<String, Object>();
 
-    
-    
+    if (options != null) {
+    	localVarFormParams.put("token", options.token);
+    }
+
 
       final String[] localVarAccepts = {
     "application/json"
       };
       final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);
 
       final String[] localVarContentTypes = {
-    
+    "application/x-www-form-urlencoded"
       };
       final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);
 

src/main/java/com/docusign/esign/api/BulkEnvelopesApi.java

@@ -401,22 +401,22 @@ public BulkEnvelopesResponse list(String accountId, BulkEnvelopesApi.ListOptions
    * Adds or replaces envelope bulk recipients.
    * Updates the bulk recipients in a draft envelope using a file upload. The Content-Type supported for uploading a bulk recipient file is CSV (text/csv).  The REST API does not support modifying individual rows or values in the bulk recipients file. It only allows the entire file to be added or replaced with a new file.
    * @param accountId The external account number (int) or account ID Guid. (required)
-   * @param envelopeId The envelopeId Guid of the envelope being accessed. (required)
-   * @param recipientId The ID of the recipient being accessed. (required)
+   * @param envelopeId The envelope's GUID. Eg 93be49ab-afa0-4adf-933c-f752070d71ec  (required)
+   * @param recipientId The `recipientId` used when the envelope or template was created. (required)
    * @param bulkRecipientsRequest  (required)
    * @return BulkRecipientsSummaryResponse
    * @throws ApiException if fails to make API call
    */
   public BulkRecipientsSummaryResponse updateRecipients(String accountId, String envelopeId, String recipientId, byte[] bulkRecipientsRequest) throws ApiException {
     Object localVarPostBody = bulkRecipientsRequest;
-
-    // verify the required parameter 'bulkRecipientsRequest' is set
-    if (bulkRecipientsRequest == null) {
+    
+      // verify the required parameter 'bulkRecipientsRequest' is set
+      if (bulkRecipientsRequest == null) {
       throw new ApiException(400, "Missing the required parameter 'bulkRecipientsRequest' when calling updateRecipients");
-    }
-
-    // verify the required parameter 'accountId' is set
-    if (accountId == null) {
+      }
+    
+      // verify the required parameter 'accountId' is set
+      if (accountId == null) {
       throw new ApiException(400, "Missing the required parameter 'accountId' when calling updateRecipients");
       }
 

src/main/java/com/docusign/esign/api/EnvelopePurgeConfigurationApi.java

@@ -0,0 +1,122 @@
+package com.docusign.esign.api;
+
+import com.sun.jersey.api.client.GenericType;
+
+import com.docusign.esign.client.ApiException;
+import com.docusign.esign.client.ApiClient;
+import com.docusign.esign.client.Configuration;
+import com.docusign.esign.client.Pair;
+
+import com.docusign.esign.model.EnvelopePurgeConfiguration;
+import com.docusign.esign.model.ErrorDetails;
+
+
+
+
+  public class EnvelopePurgeConfigurationApi {
+  private ApiClient apiClient;
+
+  public EnvelopePurgeConfigurationApi() {
+  this(Configuration.getDefaultApiClient());
+  }
+
+  public EnvelopePurgeConfigurationApi(ApiClient apiClient) {
+  this.apiClient = apiClient;
+  }
+
+  public ApiClient getApiClient() {
+  return apiClient;
+  }
+
+  public void setApiClient(ApiClient apiClient) {
+  this.apiClient = apiClient;
+  }
+
+
+  /**
+   * Select envelope purge configuration.
+   * 
+   * @param accountId The external account number (int) or account ID Guid. (required)
+   * @return EnvelopePurgeConfiguration
+   * @throws ApiException if fails to make API call
+   */
+  public EnvelopePurgeConfiguration getEnvelopePurgeConfiguration(String accountId) throws ApiException {
+    Object localVarPostBody = "{}";
+    
+      // verify the required parameter 'accountId' is set
+      if (accountId == null) {
+      throw new ApiException(400, "Missing the required parameter 'accountId' when calling getEnvelopePurgeConfiguration");
+      }
+    
+    // create path and map variables
+    String localVarPath = "/v2.1/accounts/{accountId}/settings/envelope_purge_configuration".replaceAll("\\{format\\}","json")
+      .replaceAll("\\{" + "accountId" + "\\}", apiClient.escapeString(accountId.toString()));
+
+    // query params
+    java.util.List<Pair> localVarQueryParams = new java.util.ArrayList<Pair>();
+    java.util.Map<String, String> localVarHeaderParams = new java.util.HashMap<String, String>();
+    java.util.Map<String, Object> localVarFormParams = new java.util.HashMap<String, Object>();
+
+    
+    
+    
+      final String[] localVarAccepts = {
+    "application/json"
+      };
+      final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);
+
+      final String[] localVarContentTypes = {
+    
+      };
+      final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);
+
+      String[] localVarAuthNames = new String[] { "docusignAccessCode" }; //{  };
+
+        GenericType<EnvelopePurgeConfiguration> localVarReturnType = new GenericType<EnvelopePurgeConfiguration>() {};
+        return apiClient.invokeAPI(localVarPath, "GET", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
+          }
+
+  /**
+   * Updates envelope purge configuration.
+   * 
+   * @param accountId The external account number (int) or account ID Guid. (required)
+   * @param envelopePurgeConfiguration  (optional)
+   * @return EnvelopePurgeConfiguration
+   * @throws ApiException if fails to make API call
+   */
+  public EnvelopePurgeConfiguration updateEnvelopePurgeConfiguration(String accountId, EnvelopePurgeConfiguration envelopePurgeConfiguration) throws ApiException {
+    Object localVarPostBody = envelopePurgeConfiguration;
+    
+      // verify the required parameter 'accountId' is set
+      if (accountId == null) {
+      throw new ApiException(400, "Missing the required parameter 'accountId' when calling updateEnvelopePurgeConfiguration");
+      }
+    
+    // create path and map variables
+    String localVarPath = "/v2.1/accounts/{accountId}/settings/envelope_purge_configuration".replaceAll("\\{format\\}","json")
+      .replaceAll("\\{" + "accountId" + "\\}", apiClient.escapeString(accountId.toString()));
+
+    // query params
+    java.util.List<Pair> localVarQueryParams = new java.util.ArrayList<Pair>();
+    java.util.Map<String, String> localVarHeaderParams = new java.util.HashMap<String, String>();
+    java.util.Map<String, Object> localVarFormParams = new java.util.HashMap<String, Object>();
+
+    
+    
+    
+      final String[] localVarAccepts = {
+    "application/json"
+      };
+      final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);
+
+      final String[] localVarContentTypes = {
+    
+      };
+      final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);
+
+      String[] localVarAuthNames = new String[] { "docusignAccessCode" }; //{  };
+
+        GenericType<EnvelopePurgeConfiguration> localVarReturnType = new GenericType<EnvelopePurgeConfiguration>() {};
+        return apiClient.invokeAPI(localVarPath, "PUT", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
+          }
+    }