/**
     * Builds parameter maps for search initialization, creating both query strings
     * and form inputs for the given parameters.
     *
     * @param paramMap the parameter map to process
     * @param queryKey the key for storing query string parameters
     * @param formKey the key for storing form input parameters
     */

    @Execute
    @Secured({ ROLE, ROLE + VIEW })
    public HtmlResponse index() {
        saveToken();
        return asListHtml();
    }

    /**
     * Deletes the specified plugin.
     *
     * @param form the delete form containing plugin information
     * @return HTML response redirecting to the plugin list
     */
    @Execute
    @Secured({ ROLE })
    public HtmlResponse delete(final DeleteForm form) {

 */
public interface IndexUpdateCallback {

    /**
     * Stores a document in the search index with the specified parameters and data.
     *
     * @param paramMap the data store parameters containing configuration and metadata
     * @param dataMap the document data to be indexed as key-value pairs
     */
    void store(DataStoreParams paramMap, Map<String, Object> dataMap);

    /**

    /** The username extracted from SPNEGO authentication. */
    private final String username;

    /**
     * Constructs a new SpnegoCredential with the specified username.
     *
     * @param username The username obtained from SPNEGO authentication
     */
    public SpnegoCredential(final String username) {
        this.username = username;
    }

    /**

            }, 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
     */
    protected void addPasswordValidationError(final FessMessages messages, final String errorKey) {

    public HtmlResponse back() {
        saveToken();
        return asHtml(path_AdminDesign_AdminDesignJsp).useForm(DesignForm.class);
    }

    /**
     * Upload a design file.
     * @param form The upload form.
     * @return The HTML response.
     */
    @Execute
    @Secured({ ROLE })
    public HtmlResponse upload(final UploadForm form) {

    private StorageClientFactory() {
        // Utility class
    }

    /**
     * Auto-detect storage type from endpoint URL.
     *
     * @param endpoint the storage endpoint URL
     * @return detected storage type
     */
    public static StorageType detectStorageType(final String endpoint) {
        if (StringUtil.isBlank(endpoint)) {

                }
            }
    }

    /**
     * Zip a list of files with same root directory to a zip file.
     *
     * @param destZip the target zip file
     * @param srcFiles the mapping of relative path to the file
     */
    private
    fun zip(destZip: File, srcFiles: List<Pair<String, File>>) {
        if (srcFiles.isEmpty()) {
            return

     */
    public Map<String, String> getQueryMap() {
        return queryMap;
    }

    /**
     * Adds a query to the query map with the specified display key.
     *
     * @param key the display key for the query
     * @param query the query string to add
     */
    public void addQuery(final String key, final String query) {
        queryMap.put(key, query);
    }

    /**

     *
     * @param params the map containing field names as keys and configuration values as values
     */
    public FieldConfigs(final Map<String, String> params) {
        this.params = params;
    }

    /**
     * Retrieves the configuration for the specified field name.
     *
     * @param fieldName the name of the field to get configuration for