Corrected javadocs

Author: koen-serry

pom.xml

@@ -126,9 +126,10 @@
                     <plugin>
                         <groupId>org.apache.maven.plugins</groupId>
                         <artifactId>maven-javadoc-plugin</artifactId>
-                        <version>2.9.1</version>
+                        <version>3.11.3</version>
                         <configuration>
-                            <source>8</source>
+                            <source>17</source>
+
                         </configuration>
                         <executions>
                             <execution>

src/main/java/com/twikey/DocumentGateway.java

@@ -79,7 +79,7 @@ public DocumentResponse.MandateCreationResponse create(DocumentRequests.InviteRe
     }
 
     /**
-     * See <a href="https://www.twikey.com/api/#invite-a-customer">Twikey API - Mandate Invite</a></p>
+     * See <a href="https://www.twikey.com/api/#invite-a-customer">Twikey API - Mandate Invite</a>
      *
      * Same parameters as invite, but some extra might be required depending on the method
      * <ul>
@@ -178,7 +178,7 @@ public void action(DocumentRequests.MandateActionRequest action) throws IOExcept
      *               or <code>email</code> is required.</p>
      * @return A list of {@link DocumentResponse.Document} objects containing mandate details
      * that match the query.
-     * @throws Exception                  if the request fails
+     * @throws IOException                  if the request fails
      * @throws TwikeyClient.UserException if the API returns a user-related error
      */
     public List<DocumentResponse.Document> query(DocumentRequests.MandateQuery action) throws IOException, TwikeyClient.UserException {
@@ -255,7 +255,7 @@ public void cancel(String mandateNumber, String reason, boolean notify) throws I
      *
      * @param fetch An object representing information for identifying the mandate.
      * @return A structured response object representing the server’s reply.
-     * @throws Exception                  If the API call fails or the identifier is invalid.
+     * @throws IOException                  If the API call fails or the identifier is invalid.
      * @throws TwikeyClient.UserException If the API returns an error.
      */
     public DocumentResponse.Document fetch(DocumentRequests.MandateDetailRequest fetch) throws IOException, TwikeyClient.UserException {

src/main/java/com/twikey/InvoiceGateway.java

@@ -282,7 +282,7 @@ public String createBatch(InvoiceRequests.BulkInvoiceRequest batch) throws IOExc
      * whether invoices were successfully created or failed during batch upload.
      *
      * @param batchId The unique batch ID returned when the bulk invoice upload was created.
-     * @return Map<String, String> A mapping of invoice identifiers to their respective statuses.
+     * @return BulkInvoiceDetail containing invoice identifiers to their respective statuses.
      * @throws IOException                If a network error occurs while making the request.
      * @throws TwikeyClient.UserException If the API rejects the request or returns a user-related error.
      */

src/main/java/com/twikey/modal/DocumentRequests.java

@@ -238,7 +238,7 @@ public InviteRequest(long ct) {
         }
 
         /**
-         * Convert this request to a flat Map<String,String> suitable for the API.
+         * Convert this request to a flat Map suitable for the API.
          */
         public Map<String, String> toRequest() {
             Map<String, String> result = new HashMap<>();
@@ -327,7 +327,7 @@ public InviteRequest setPrefix(String prefix) {
             return this;
         }
 
-        public InviteRequest setExpiryd(long epoch) {
+        public InviteRequest setExpiry(long epoch) {
             this.ed = ed;
             return this;
         }
@@ -764,7 +764,7 @@ public UpdateMandateRequest(String mndtId) {
         }
 
         /**
-         * Convert this request to a flat Map<String,String> suitable for the API.
+         * Convert this request to a flat Map suitable for the API.
          */
         public Map<String, String> toRequest() {
             Map<String, String> result = new HashMap<>();

src/main/java/com/twikey/modal/InvoiceRequests.java

@@ -288,7 +288,7 @@ private static void putIfNotNull(JSONObject json, String key, Object value) {
         }
 
         /**
-         * Convert this request to a flat Map<String,String> suitable for the API.
+         * Convert this request to a flat JSONObject suitable for the API.
          */
         public JSONObject toRequest() {
             JSONObject result = new JSONObject();

src/main/java/com/twikey/modal/TransactionRequests.java

@@ -311,7 +311,7 @@ public Map<String, String> toRequest() {
      * <p>Typical usage:</p>
      * <pre>
      *     ActionRequest request = new ActionRequest("345", ActionRequest.Action.REOFFER);
-     *     Map<String, String> params = request.toRequest();
+     *     var params = request.toRequest();
      *     // pass params into your OkHttp FormBody builder
      * </pre>
      *