verify(session, times(1)).treeConnectLogon();
    }

    // Error propagation: connect to logon share throws SmbException
    @Test
    @DisplayName("treeConnectLogon throws SmbException when underlying call fails")
    void treeConnectLogon_throws() throws SmbException {
        doThrow(new SmbException("logon failed")).when(session).treeConnectLogon();

     * @param bufferIndex the starting index in the buffer
     * @param len the maximum length of data to decode
     * @return decoded length
     * @throws SMBProtocolDecodingException if decoding fails
     */
    int decode(byte[] buffer, int bufferIndex, int len) throws SMBProtocolDecodingException;

    expectedEvents += "RequestHeadersStart"
    expectedEvents += "RequestHeadersEnd"
    expectedEvents += "RequestBodyStart"
    // ... but we can read the response even after writing the request fails.
    expectedEvents += "RequestFailed"
    expectedEvents += "ResponseHeadersStart"
    expectedEvents += "ResponseHeadersEnd"
    expectedEvents += "FollowUpDecision"
    expectedEvents += "ResponseBodyStart"

     * @param buffer source buffer
     * @param bufferIndex starting index in source buffer
     * @param len length of data to read
     * @return number of bytes read
     * @throws SMBProtocolDecodingException if decoding fails
     */
    protected abstract int readParametersWireFormat(byte[] buffer, int bufferIndex, int len) throws SMBProtocolDecodingException;

    /**
     * Reads data from wire format
     * @param buffer source buffer

        assertEquals(cap >= 0, result);
        verify(transport, times(1)).hasCapability(cap);
    }

    // Invalid input: simulate underlying SmbException when capability check fails
    @Test
    @DisplayName("hasCapability throws SmbException when underlying error occurs")
    void hasCapability_throws() throws SmbException {

     *
     * @param uri the URI to process
     * @param includeContent whether to include content in the response
     * @return the response data
     * @throws CrawlingAccessException if the request fails
     */
    protected ResponseData processRequest(final String uri, final boolean includeContent) {
        if (!isInit.get()) {
            synchronized (isInit) {
                if (!isInit.get()) {

    /**
     * Creates a Role entity from form data.
     *
     * @param form the form containing the role data
     * @return optional entity containing the role data, or empty if creation fails
     */
    private static OptionalEntity<Role> getEntity(final CreateForm form) {
        switch (form.crudMode) {
        case CrudMode.CREATE:
            return OptionalEntity.of(new Role()).map(entity -> {

        extractorMap.put("svg", new XmlExtractor());
    }

    /**
     * Initializes the extractor by starting the office manager.
     *
     * @throws CrawlerSystemException if the office manager is null or fails to start
     */
    @PostConstruct
    public void init() {
        if (officeManager == null) {
            throw new CrawlerSystemException("officeManager is null.");
        }
        try {

   * pipeline is done (other than those captured by the returned {@link ClosingFuture}).
   *
   * <p>If this {@code ClosingFuture} fails with an exception of the given type, the derived {@code
   * ClosingFuture} will be equivalent to the one returned by the function.
   *
   * <p>If this {@code ClosingFuture} succeeds or fails with a different exception type, the
   * function will not be called, and the derived {@code ClosingFuture} will be equivalent to this

 * This form extends CreateForm to include fields necessary for updating existing duplicate host entries,
 * including tracking information for optimistic locking and audit trails.
 * Duplicate hosts are used to define which domains should be treated as the same site for crawling purposes.
 *
 */
public class EditForm extends CreateForm {

    /**
     * Creates a new EditForm instance.