add tests for pagination

Author: niteshsandal-merge

.github/workflows/ci.yml

@@ -36,6 +36,10 @@ jobs:
 
       - name: Test
         run: ./gradlew test
+        env:
+          MERGE_API_KEY_FILESTORAGE: ${{ secrets.MERGE_API_KEY_FILESTORAGE }}
+          MERGE_ACCOUNT_TOKEN_FILESTORAGE: ${{ secrets.MERGE_ACCOUNT_TOKEN_FILESTORAGE }}
+
   publish:
     needs: [ compile, test ]
     if: github.event_name == 'push' && contains(github.ref, 'refs/tags/')

src/test/java/com/merge/api/integration/CursorPaginationIntegrationTest.java

@@ -0,0 +1,126 @@
+package com.merge.api.integration;
+
+import com.merge.api.MergeApi;
+import com.merge.api.core.SyncPagingIterable;
+import com.merge.api.filestorage.types.Folder;
+import com.merge.api.filestorage.types.PaginatedFolderList;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+@EnabledIfEnvironmentVariable(named = "MERGE_API_KEY_FILESTORAGE", matches = ".+")
+@EnabledIfEnvironmentVariable(named = "MERGE_ACCOUNT_TOKEN_FILESTORAGE", matches = ".+")
+public class CursorPaginationIntegrationTest {
+
+    private MergeApi client;
+
+    @BeforeEach
+    void setUp() {
+        String apiKey = System.getenv("MERGE_API_KEY_FILESTORAGE");
+        String accountToken = System.getenv("MERGE_ACCOUNT_TOKEN_FILESTORAGE");
+
+        assertNotNull(apiKey, "MERGE_API_KEY environment variable must be set");
+        assertNotNull(accountToken, "MERGE_ACCOUNT_TOKEN environment variable must be set");
+
+        client = MergeApi.builder()
+                .apiKey(apiKey)
+                .accountToken(accountToken)
+                .build();
+    }
+
+    @Test
+    void testCursorPaginationWithFileStorageFolders() {
+        SyncPagingIterable<Folder> folders = client.filestorage().folders().list();
+
+        assertNotNull(folders, "Folders list should not be null");
+
+        // Test that getResponse() is available and returns pagination metadata
+        folders.getResponse().ifPresent(response -> {
+            assertTrue(response instanceof PaginatedFolderList,
+                "Response should be instance of PaginatedFolderList");
+
+            PaginatedFolderList paginatedResponse = (PaginatedFolderList) response;
+
+            // Test cursor pagination metadata access
+            if (paginatedResponse.getNext() != null) {
+                assertNotNull(paginatedResponse.getNext(),
+                    "Cursor token should be available for pagination");
+            }
+
+            // Test that we can access results
+            assertNotNull(paginatedResponse.getResults(),
+                "Results list should not be null");
+        });
+
+        // Test iteration over paginated results
+        int itemCount = 0;
+        int pageCount = 0;
+
+        for (Folder folder : folders) {
+            assertNotNull(folder, "Each folder should not be null");
+            itemCount++;
+
+            // Limit test to prevent excessive API calls
+            if (itemCount >= 10) {
+                break;
+            }
+        }
+
+        assertTrue(itemCount >= 0, "Should have processed at least 0 items");
+    }
+
+    @Test
+    void testStatelessPaginationWithCursor() {
+        SyncPagingIterable<Folder> firstPage = client.filestorage().folders().list();
+
+        // Get the first page response to extract cursor
+        firstPage.getResponse().ifPresent(response -> {
+            assertTrue(response instanceof PaginatedFolderList,
+                "Response should be PaginatedFolderList");
+
+            PaginatedFolderList paginatedResponse = (PaginatedFolderList) response;
+
+            // If there's a next cursor, test stateless pagination
+            if (paginatedResponse.getNext() != null && !paginatedResponse.getNext().isEmpty()) {
+                String nextCursor = paginatedResponse.getNext();
+
+                // This demonstrates how a user would implement stateless pagination
+                // by using the cursor token from the response
+                assertNotNull(nextCursor, "Next cursor should be available");
+                assertFalse(nextCursor.trim().isEmpty(), "Next cursor should not be empty");
+
+                // Note: In a real implementation, you would use this cursor
+                // to make subsequent requests with the cursor parameter
+                System.out.println("Successfully extracted cursor token: " + nextCursor.substring(0, Math.min(10, nextCursor.length())) + "...");
+            }
+        });
+    }
+
+    @Test
+    void testPaginationMetadataAccess() {
+        SyncPagingIterable<Folder> folders = client.filestorage().folders().list();
+
+        // Test that getResponse() provides access to full API response
+        assertTrue(folders.getResponse().isPresent(),
+            "getResponse() should return the API response");
+
+        folders.getResponse().ifPresent(response -> {
+            // Verify we can cast to the expected response type
+            assertDoesNotThrow(() -> {
+                PaginatedFolderList paginatedResponse = (PaginatedFolderList) response;
+
+                // Test access to pagination metadata
+                // These fields may be null if no pagination is needed
+                String next = paginatedResponse.getNext();
+                String previous = paginatedResponse.getPrevious();
+
+                // At minimum, results should be accessible
+                assertNotNull(paginatedResponse.getResults(),
+                    "Results should always be accessible");
+
+            }, "Should be able to access pagination metadata");
+        });
+    }
+}