* This class provides functionality to track, record, and report statistics
 * about crawler operations including timing data, performance metrics, and
 * operational events. It uses an internal cache to maintain statistics
 * objects and provides methods to begin tracking, record events, and
 * finalize statistics collection.
 *
 */
public class CrawlerStatsHelper {

    /**

        } catch (CrawlingAccessException e) {
            assertTrue(e.getCause() instanceof InterruptedException);
        }
    }

    public void test_temp_file_creation() {
        // Test that temp file uses correct prefix "S3Client" not "StorageClient"
        S3Client client = new S3Client() {
            @Override
            protected java.io.File createTempFile(String prefix, String suffix, java.io.File directory) {

        assertNotNull(newWriter);
    }

    @Test
    public void test_writeItemsUsesSettingsTimeout() throws Exception {
        // This test verifies that the writer uses settings.getIndexTimeout()
        // instead of a hardcoded timeout value
        String[][] readings = new String[1][];
        readings[0] = new String[] { "test" };

        @Test
        @DisplayName("Test is resolve in DFS")
        void testIsResolveInDfs() {
            assertFalse(testBlock.isResolveInDfs());

            // The isResolveInDfs() implementation incorrectly uses getFlags() with FLAGS2 constant
            // Since FLAGS2_RESOLVE_PATHS_IN_DFS is 0x1000, when cast to byte it becomes 0
            // Therefore the method will always return false unless flags has all 0x00 bits set

        ndrBuffer.enc_ndr_referent(obj2, 3);
        assertEquals(4, ndrBuffer.getIndex());
        assertEquals(System.identityHashCode(obj2), Encdec.dec_uint32le(buffer, 0));

        // Test ptr type (type 2) - uses internal referent map
        ndrBuffer.reset();
        ndrBuffer.enc_ndr_referent(obj1, 2);
        assertEquals(4, ndrBuffer.getIndex());
        int referent1 = Encdec.dec_uint32le(buffer, 0);

        SmbFileHandleImpl h = new SmbFileHandleImpl(cfg, 42, tree, "//s/share", 0xA, 0xB, 0xC, 0xD, 0L);

        long lastWrite = 123456789L;
        h.close(lastWrite);

        // Verify SMB1 close path uses request + response overload
        ArgumentCaptor<CommonServerMessageBlockRequest> reqCap = ArgumentCaptor.forClass(CommonServerMessageBlockRequest.class);

        verify(transport).close();
    }

    @Test
    @DisplayName("getServerTimeZoneOffset: SMB1 negotiate path multiplies minutes to millis")
    void getServerTimeZoneOffsetSmb1() throws Exception {
        // Uses concrete SMB1 negotiate response to exercise SMB1-specific branch
        // Build a concrete SMB1 negotiate response to expose ServerData fields
        jcifs.CIFSContext ctx = mock(jcifs.CIFSContext.class);

            super.storeChildUrl(url, parentUrl, weight, depth);
        }
    }

    /**
     * Retrieves the appropriate crawler client for the given URL based on configured rules.
     * This method uses client rules to determine which specific client implementation
     * should be used for crawling the URL, falling back to the default client if no
     * specific rule matches.
     *

        InputStream in = new ByteArrayInputStream(concat(messageHeader(3), data));
        SocketInputStream sis = new SocketInputStream(in);

        // Try to skip more than available
        // Skip uses read internally, which may throw IOException when it tries to read the next header
        try {
            long skipped = sis.skip(10);
            // If it doesn't throw, it should only skip what's available

    default int getLtrWindowSize() {
        return getSystemPropertyAsInt(Constants.LTR_WINDOW_SIZE_PROPERTY, 100);
    }

    /**
     * Gets the permission fields for Entra ID authentication.
     * Uses new entraid.permission.fields key with fallback to legacy aad.permission.fields.
     * @return Array of permission field names.
     */
    default String[] getEntraIdPermissionFields() {