fix typos & rename enqueue() method on V2

Author: sebastianMindee

src/main/java/com/mindee/MindeeClientV2.java

@@ -34,16 +34,17 @@ public MindeeClientV2(MindeeApiV2 mindeeApi) {
   }
 
   /**
-   * Enqueue a document in the asynchronous “Generated” queue.
+   * Enqueue a document in the asynchronous queue.
    */
-  public JobResponse enqueue(
+  public JobResponse enqueueInference(
       LocalInputSource inputSource,
       InferenceParameters params) throws IOException {
     return mindeeApi.reqPostInferenceEnqueue(inputSource, params);
   }
 
   /**
-   * Poll queue for a previously enqueued document.
+   * Get the status of an inference that was previously enqueued.
+   * Can be used for polling.
    */
   public JobResponse getJob(String jobId) {
     if (jobId == null || jobId.trim().isEmpty()) {
@@ -53,11 +54,12 @@ public JobResponse getJob(String jobId) {
   }
 
   /**
-   * Retrieve results for a previously enqueued document.
+   * Get the result of an inference that was previously enqueued.
+   * The inference will only be available after it has finished processing.
    */
   public InferenceResponse getInference(String inferenceId) {
     if (inferenceId == null || inferenceId.trim().isEmpty()) {
-      throw new IllegalArgumentException("jobId must not be null or blank.");
+      throw new IllegalArgumentException("inferenceId must not be null or blank.");
     }
 
     return mindeeApi.reqGetInference(inferenceId);
@@ -77,7 +79,7 @@ public InferenceResponse enqueueAndGetInference(
 
     validatePollingOptions(options.getPollingOptions());
 
-    JobResponse job = enqueue(inputSource, options);
+    JobResponse job = enqueueInference(inputSource, options);
 
     Thread.sleep((long) (options.getPollingOptions().getInitialDelaySec() * 1000));
     JobResponse resp = job;
@@ -102,7 +104,7 @@ else if (resp.getJob().getStatus().equals("Processed")) {
   }
 
   /**
-   * Deserialize a webhook payload (or any saved response) into
+   * Deserialize a webhook payload (or any saved response) into an
    * {@link InferenceResponse}.
    */
   public InferenceResponse loadInference(LocalResponse localResponse) throws IOException {

src/test/java/com/mindee/MindeeClientV2IT.java

@@ -103,7 +103,7 @@ void invalidModel_mustThrowError() throws IOException {
 
     MindeeHttpExceptionV2 ex = assertThrows(
         MindeeHttpExceptionV2.class,
-        () -> mindeeClient.enqueue(source, options)
+        () -> mindeeClient.enqueueInference(source, options)
     );
     assertEquals(422, ex.getStatus());
   }

src/test/java/com/mindee/MindeeClientV2Test.java

@@ -41,7 +41,7 @@ void enqueue_post_async() throws IOException {
 
       LocalInputSource input =
           new LocalInputSource(new File("src/test/resources/file_types/pdf/blank_1.pdf"));
-      JobResponse response = mindeeClient.enqueue(
+      JobResponse response = mindeeClient.enqueueInference(
           input,
           InferenceParameters.builder("dummy-model-id").build()
       );