public void updateChild(String childName, SmbFileAttributes attrs) {
        lock.writeLock().lock();
        try {
            FileInfo existing = children.get(childName);
            FileInfo newInfo = new FileInfo(childName, attrs);
            
            if (existing == null || !existing.matches(attrs)) {
                children.put(childName, newInfo);
                hasChanges = true;

                // For testing purposes, continue processing other files
                // In a real scenario, you might want to handle this differently
            }
        }

        return files;
    }

    /**
     * Update directory cache with new listing
     *
     * @param directoryPath directory path

        assertFalse(cacheEntry.isComplete());

        // Step 3: Verify can cache directory listing
        assertTrue(directoryLeaseManager.canCacheDirectoryListing(directoryPath));

        // Step 4: Initially no cached listing
        assertNull(directoryLeaseManager.getCachedDirectoryListing(directoryPath));

        // Step 5: Simulate directory enumeration and update cache

        verify(response).setHeader("WWW-Authenticate", "NTLM");
        verify(response).flushBuffer();
    }

    /**
     * Test doGet with NTLM authentication for directory listing
     * This test verifies the authentication flow without actual network operations
     */
    @Test
    void testDoGet_DirectoryListing() throws Exception {

        directoryLeaseManager.requestDirectoryLease(directoryPath, DirectoryLeaseState.DIRECTORY_READ_HANDLE,
                DirectoryCacheScope.IMMEDIATE_CHILDREN);

        // No cached listing initially
        assertNull(directoryLeaseManager.getCachedDirectoryListing(directoryPath));

        // Setup mock files
        when(mockFile1.getName()).thenReturn("file1.txt");

        it.close();
        verify(tree).send(argThat((Request<?> r) -> r instanceof Smb2CloseRequest));
    }

    @Test
    @DisplayName("open() gracefully handles NT_STATUS_NO_SUCH_FILE (empty listing)")
    void open_handles_no_such_file_and_yields_empty() throws Exception {
        // Setup required for this test
        when(parent.getLocator()).thenReturn(locator);

 * to interact with SMB resources.
 *
 * <p>
 * This client supports authentication, content retrieval, and metadata extraction from SMB files.
 * It handles file access, directory listing, and access control entries (ACEs) processing.
 * </p>
 *
 * <p>
 * The class provides methods to:
 * </p>
 * <ul>
 *   <li>Initialize the client with SMB authentication details.</li>

    C --> F[Witness Protocol]
    D --> F
```

## Testing Strategy

### Unit Tests
- Individual component testing for each feature
- Mock-based testing for protocol interactions
- State machine validation

### Integration Tests
- Feature interaction testing
- Network failure simulation
- Performance benchmarking
- Compatibility testing with Windows Server 2016/2019/2022

 *   <li>Content length validation</li>
 *   <li>MIME type detection</li>
 *   <li>Handling of large files through temporary file storage</li>
 *   <li>Object metadata and tags retrieval</li>
 *   <li>Directory listing capabilities</li>
 * </ul>
 *
 * <p>The client handles timeout management for access operations and includes proper
 * resource cleanup mechanisms.
 */
public class S3Client extends AbstractCrawlerClient {

        if (f1.isDirectory()) {
            return f1name.compareToIgnoreCase(f2.getName());
        }
        return f1.lastModified() > f2.lastModified() ? -1 : 1;
    }

    /**
     * Handles directory listing requests for SMB directories.
     * @param req the HTTP servlet request
     * @param resp the HTTP servlet response
     * @param dir the SMB directory to list
     * @throws IOException if an I/O error occurs
     */