import org.opensearch.index.query.QueryBuilder;
import org.opensearch.search.SearchHit;

/**
 * Helper class for scroll-based search operations in OpenSearch.
 * Centralizes scroll logic to reduce code duplication across settings and indexer classes.
 *
 * <p>This class provides methods to perform scroll-based searches with different processing patterns:
 * <ul>

        this.clusterTimeout = timeout;
    }

    /**
     * Gets the scroll timeout.
     * @return The scroll timeout.
     */
    public String getScrollTimeout() {
        return scrollTimeout;
    }

    /**
     * Sets the scroll timeout.
     * @param timeout The scroll timeout.
     */
    public void setScrollTimeout(final String timeout) {

        }

        // Verify that the scroll method exists with correct signature
        try {
            SearchEngineUtil.class.getMethod("scroll", String.class, java.util.function.Function.class);
        } catch (NoSuchMethodException e) {
            fail("scroll method should exist with correct signature");
        }
    }

    @Test

    }

    /**
     * Prepares a clear scroll request builder.
     *
     * @return the clear scroll request builder
     */
    @Override
    public ClearScrollRequestBuilder prepareClearScroll() {
        return client.prepareClearScroll();
    }

    /**
     * Clears scroll contexts asynchronously.
     *
     * @param request the clear scroll request

        when(mockSearchResponse.getScrollId()).thenReturn("scroll1", "scroll1");
        when(mockSearchResponse.getHits()).thenReturn(mockSearchHits);
        when(mockSearchHits.getHits()).thenReturn(new SearchHit[] { mockHit }, new SearchHit[0]);
        when(mockHit.getIndex()).thenReturn("test-index");
        when(mockHit.getId()).thenReturn("doc1");

        // Setup scroll response (empty on second call)

            docIds.addAll(resultIds);
            Map<String, Object> scrollBody = new HashMap<>();
            scrollBody.put("scroll", "1m");
            scrollBody.put("scroll_id", scrollId);
            response = given().contentType("application/json").body(scrollBody).get(getEsUrl() + "/_search/scroll");
            jsonPath = JsonPath.from(response.asString());
        }

        for (String docId : docIds) {

     */
    public SuggestSettingsBuilder addInitialSettings(final String key, final Object value) {
        initialSettings.put(key, value);
        return this;
    }

    /**
     * Sets the scroll timeout.
     * @param timeout The scroll timeout.
     * @return This builder instance.
     */
    public SuggestSettingsBuilder scrollTimeout(final String timeout) {
        timeoutSettings.setScrollTimeout(timeout);
        return this;

 *
 * This class provides comprehensive search functionality including document search,
 * scroll search, and bulk operations. It handles search request parameter processing,
 * query building, response formatting, and search log management.
 *
 * Key features:
 * - Document search with pagination and faceting
 * - Scroll search for large result sets
 * - Document retrieval by ID
 * - Bulk document updates

import io.restassured.path.json.JsonPath;
import io.restassured.response.Response;

/**
 * Integration tests for the Scroll Search API (/api/v1/documents/all)
 * This test requires crawled documents and api.search.scroll to be enabled
 */
@Tag("it")
@Disabled("Requires api.search.scroll to be enabled in fess_config.properties")
public class ScrollSearchApiTests extends CrawlTestBase {

            if (logger.isDebugEnabled()) {
                logger.debug("Failed to process a scroll request.", e);
            }
            writeJsonResponse(HttpServletResponse.SC_BAD_REQUEST, e);
        } catch (final Exception e) {
            if (logger.isDebugEnabled()) {
                logger.debug("Failed to process a scroll request.", e);
            }