- **SuggestIndexer**: Thread-safe for indexing
- **SuggestSettings**: NOT thread-safe for modifications

### Performance
- Use batch operations for indexing (100-500 items)
- Don't call `refresh()` too frequently
- Limit `maxReadingNum` to prevent memory issues
- OpenSearch auto-refreshes every 1 second by default

### Compatibility
- Designed for OpenSearch 2.x+
- All text processing uses UTF-8

                // Exponential backoff with overflow protection - ensure safe calculation
                if (retryDelayMs > 0) {
                    // Safe calculation preventing overflow: use Math.max(0, retryCount - 1) and limit shift
                    int safeShift = Math.min(MAX_BACKOFF_SHIFT, Math.max(0, retryCount - 1));
                    long multiplier = 1L << safeShift;
                    // Check for potential overflow before multiplication

    /** The maximum depth for crawling. A value of -1 indicates no depth check. */
    protected int maxDepth = -1;

    /** The maximum number of URLs to access. A value of 0 indicates no limit. */
    protected long maxAccessCount = 0;

    /**
     * Returns the session ID.
     * @return The session ID.
     */
    public String getSessionId() {
        return sessionId;
    }

        // When - initially should not need rotation
        assertFalse(context.needsKeyRotation(), "Should not need rotation initially");

        // Note: We can't directly test the byte limit without encrypting large amounts of data,
        // but we can verify the method exists and returns proper boolean
    }

    @Test
    @DisplayName("Should reset key rotation tracking")

        // Then
        assertSame(timeZone, resultTimeZone, "Should delegate time zone");
        verify(mockDelegate).getLocalTimezone();
    }

    @Test
    @DisplayName("Batch limit configuration should delegate correctly")
    void testBatchLimitDelegation() {
        // Given
        String operation = "TestOperation";
        when(mockDelegate.getBatchLimit(operation)).thenReturn(100);

    public int available() throws IOException {
        return inputStream.available();
    }

    /**
     * Marks the current position in this input stream.
     *
     * @param readlimit the maximum limit of bytes that can be read before the mark position becomes invalid
     */
    @Override
    public synchronized void mark(final int readlimit) {
        inputStream.mark(readlimit);
    }

    /**

    /** The access timeout in seconds. Default is null (no timeout). */
    protected Integer accessTimeout = null; // seconds

    /** The maximum content length in bytes. Default is null (no limit). */
    protected Long maxContentLength = null;

    /**
     * Constructs a new AbstractCrawlerClient.
     */
    public AbstractCrawlerClient() {
        // NOP
    }

    /**

    }

    @Test
    @DisplayName("Test getBatchLimit method")
    void testGetBatchLimit() {
        // Test default batch limit
        assertEquals(0, config.getBatchLimit("TreeConnectAndX.QueryInformation"));

        // Test unspecified batch limit
        assertEquals(1, config.getBatchLimit("UnknownCommand"));

        // Test caching behavior

                .limit(count)
                .forEach(entry -> {
                    Smb2LeaseKey key = entry.getKey();
                    LeaseEntry lease = entry.getValue();
                    log.info("Evicting lease for path: {} due to max lease limit", lease.getPath());

                    // Flush any cached data before eviction

    }

    @Test
    void testFailoverStateRetryLogic() {
        ChannelFailover.FailoverState state = new ChannelFailover.FailoverState("test-channel");

        // Should allow retries up to limit
        assertTrue(state.shouldRetry());

        state.incrementRetry(); // Retry 1
        assertTrue(state.shouldRetry());

        state.incrementRetry(); // Retry 2
        assertTrue(state.shouldRetry());