} catch (final Exception e) {
            logger.warn("Failed to update thumbnail field at {}", thumbnailId, e);
        }
    }

    /**
     * Processes thumbnail generation with a consumer function.
     * @param id The document ID.
     * @param consumer The consumer function to process thumbnail and config ID.
     * @return True if processing was successful, false otherwise.
     */

                }, validationErrorLambda);
            }
        }
    }

    /**
     * Adds a password validation error message to the messages object based on the error key.
     *
     * @param messages the FessMessages object to add the error to
     * @param errorKey the error key identifying the type of password validation error
     */

     * This is a required field for identifying which related content entry to update.
     */
    @Required
    @Size(max = 1000)
    public String id;

    /**
     * The username of the user who last updated this related content configuration.
     * Used for audit trail purposes to track who made changes.
     */
    @Size(max = 1000)
    public String updatedBy;

    /**

     * This is a required field for identifying which web authentication entry to update.
     */
    @Required
    @Size(max = 1000)
    public String id;

    /**
     * The username of the user who last updated this web authentication configuration.
     * Used for audit trail purposes to track who made changes.
     * Maximum length is 255 characters.
     */
    @Size(max = 255)

 * - [aliases] — all known POM `<licenses><license><name>` strings that map to this license;
 *   used by [GenerateLicenseFile] to normalise inconsistent spellings across the Maven ecosystem
 *
 * ## Adding a new dependency with an unrecognised license
 *
 * If `./gradlew generateLicenseFile` fails with "declare a license name not registered in
 * License.kt", add the raw POM name string to the [aliases] list of the matching entry, or

        // Default constructor
    }

    /**
     * Wraps a query string with wildcard characters to enable partial matching.
     * This method ensures that the query string is surrounded by asterisks (*)
     * to support prefix and suffix matching in search operations.
     *
     * @param query the query string to wrap with wildcards
     * @return the wrapped query string with leading and trailing asterisks
     */

        // Tweak the imports due to some inconsistencies introduced before we automated the default-imports generation
        excludedPackages.add("org.gradle.plugins.ide.eclipse.model");
        excludedPackages.add("org.gradle.plugins.ide.idea.model");
        excludedPackages.add("org.gradle.api.tasks.testing.logging");

        // TODO - rename some incubating types to remove collisions and then remove these exclusions

     * with parameters from the paramMap substituted into the template.
     *
     * @param template the template string to evaluate
     * @param paramMap the map of parameters to substitute into the template
     * @return the result of evaluating the template, or null if evaluation fails
     */
    Object evaluate(final String template, final Map<String, Object> paramMap);

                resource -> accessContextLogic.create(resource, OptionalThing::empty, OptionalThing::empty, () -> APP_TYPE));
    }

    /**
     * Sets the job class to be executed by this scheduler.
     *
     * @param jobClass the job class to set
     */
    public void setJobClass(final Class<? extends LaJob> jobClass) {
        this.jobClass = jobClass;
    }

    }

    /**
     * Delays the crawler while waiting for new URLs to be available.
     * This method calibrates CPU load, checks crawler status, applies
     * interval control rules, and then calls the parent implementation.
     * All operations are wrapped in exception handling to ensure robustness
     * in test and production environments.
     */
    @Override