// Internal helper methods

  /** Circularly increment i. */
  final int inc(int i) {
    return (++i == items.length) ? 0 : i;
  }

  /**
   * Inserts element at current put position, advances, and signals. Call only when occupying
   * monitor.
   */
  private void insert(E x) {
    items[putIndex] = x;
    putIndex = inc(putIndex);
    ++count;
  }

  /**

   */
  public MonitorBasedPriorityBlockingQueue(Collection<? extends E> c) {
    q = new PriorityQueue<E>(c);
  }

  /**
   * Inserts the specified element into this priority queue.
   *
   * @param e the element to add
   * @return {@code true} (as specified by {@link Collection#add})

 * @see eu.maveniverse.domtrip.Editor
 * @see eu.maveniverse.domtrip.maven.PomEditor
 */
public class DomUtils {

    private DomUtils() {
        // Utility class
    }

    /**
     * Inserts a new child element to the given parent element with proper Maven POM ordering.
     *
     * @param name the name of the new element
     * @param parent the parent element
     * @return the new element
     *
     */

     *
     * @param sessionId The session ID.
     * @param url The URL.
     */
    void add(String sessionId, String url);

    /**
     * Inserts a URL queue.
     *
     * @param urlQueue The URL queue.
     */
    void insert(QUEUE urlQueue);

    /**
     * Deletes a URL queue.
     *
     * @param sessionId The session ID.
     */
    void delete(String sessionId);

    /**

     * Default constructor for AuthenticationManager.
     */
    public AuthenticationManager() {
        // Default constructor
    }

    /**
     * Inserts a new user across all authentication chains.
     * @param user The user to insert.
     */
    public void insert(final User user) {
        chains().of(stream -> stream.forEach(c -> c.update(user)));
    }

    /**

     */
    public OptionalEntity<RelatedContent> getRelatedContent(final String id) {
        return relatedContentBhv.selectByPK(id);
    }

    /**
     * Stores (inserts or updates) a related content entity.
     * After storing, updates the related content helper to refresh the cache.
     *
     * @param relatedContent the RelatedContent entity to store
     */

     */
    public OptionalEntity<RelatedQuery> getRelatedQuery(final String id) {
        return relatedQueryBhv.selectByPK(id);
    }

    /**
     * Stores (inserts or updates) a related query in the database.
     * After storing, the related query helper is updated to refresh the cache.
     *
     * @param relatedQuery the RelatedQuery entity to store
     */

        asyncManager.async(() -> {
            insertLogin(user);
        });
    }

    /**
     * Inserts a login record for the given member.
     * Currently this method does nothing.
     *
     * @param member the member to insert a login record for
     */
    protected void insertLogin(final Object member) {
        // nothing
    }

    /**

     */
    public OptionalEntity<DuplicateHost> getDuplicateHost(final String id) {
        return duplicateHostBhv.selectByPK(id);
    }

    /**
     * Stores (inserts or updates) a duplicate host configuration.
     *
     * <p>This method immediately refreshes the index to ensure the change is visible.
     * If the configuration already exists (based on ID), it will be updated;

                    }
                });

    }

    /**
     * Inserts or updates a user in LDAP directory.
     *
     * @param user the user object to insert or update
     */
    public void insert(final User user) {
        if (!fessConfig.isLdapAdminEnabled(user.getName())) {
            return;
        }