* group, and symbolic links.
 *
 * <p>
 * The class uses Apache Commons Net library for FTP communication. It maintains a queue of FTPClient
 * instances to improve performance by reusing connections.
 * </p>
 *
 * <p>
 * The client can be configured with FTP-specific settings via init parameters, such as:
 * </p>
 * <ul>

 * processing the response, and extracting child URLs.
 *
 * <p>
 * This class implements the {@link Runnable} interface, allowing it to be executed in a separate thread.
 * It uses various services and components, such as {@link UrlQueueService}, {@link DataService},
 * {@link CrawlerContainer}, {@link LogHelper}, {@link CrawlerClientFactory}, and {@link CrawlerContext},
 * to perform its tasks.
 * </p>
 *
 * <p>

        public int decrement() {
            return count.decrementAndGet();
        }
    }

    /**
     * Enumeration of predefined statistics actions that can be recorded
     * during crawler operations. Each action represents a specific event
     * or milestone in the crawling process.
     */
    public enum StatsAction {
        /** Indicates that a URL was successfully accessed. */
        ACCESSED,

 *   <li>Handle timeouts during SMB operations.</li>
 * </ul>
 *
 * <p>
 * The client uses a {@link SmbAuthenticationHolder} to manage SMB authentication credentials.
 * It also integrates with other Fess Crawler components, such as {@link ContentLengthHelper} and
 * {@link MimeTypeHelper}, to handle content length checks and MIME type detection.
 * </p>
 *
 * <p>
 * The class uses JCIFS properties to configure the SMB connection.
 * </p>
 *

        }
    }

    @Nested
    @DisplayName("Mock Tests")
    class MockTests {

        @Test
        @DisplayName("Should call encode on each chunk")
        void testCallsEncodeOnEachChunk() {
            // Given
            byte[] sourceKey = new byte[SOURCE_KEY_SIZE];
            SrvCopychunk mockChunk1 = mock(SrvCopychunk.class);

        // Test at various positions in the buffer
        int[] positions = { 0, 10, 50, 100, 150 };

        for (int pos : positions) {
            when(mockConfig.getPid()).thenReturn(1234); // Mock getPid for each new instance
            response = new TestSmbComNtTransactionResponse(mockConfig); // Reset response

            // Fill buffer at position
            for (int i = 0; i < 37; i++) {

            domains.domains[0].sid = new jcifs.dcerpc.rpc.sid_t();
            rpc.domains = domains;

            // Names: provide account names and types for each SID
            lsarpc.LsarTransNameArray names = new lsarpc.LsarTransNameArray();
            names.count = in.length;
            names.names = new lsarpc.LsarTranslatedName[in.length];
            // First is a user

                10, // max attempts per IP (higher than default 5)
                100, // max global attempts per minute (much higher than default 20)
                Duration.ofSeconds(2), Duration.ofMinutes(1));

        try {
            final int numThreads = 10;
            final int attemptsPerThread = 5;

        addressArrayField.setAccessible(true);
        NbtAddress[] addresses = (NbtAddress[]) addressArrayField.get(response);
        assertEquals(numNames, addresses.length);

        // Verify each address has correct data
        for (int i = 0; i < numNames; i++) {
            assertNotNull(addresses[i]);
            assertTrue(addresses[i].isActive);
            assertFalse(addresses[i].groupName);
        }

     */
    private SmbResource createMockResource() {
        return mock(SmbResource.class);
    }

    @BeforeEach
    void setUp() {
        // Reset mocks to ensure clean state for each test
        reset(mockResource, mockLocator, mockContext);
    }

    @Nested
    @DisplayName("Interface Contract Tests")
    class InterfaceContractTests {

        @Test