/**
     * Opens an output stream writing to the file (write only, exclusive write access)
     *
     * @param append
     *            whether to append to or truncate the input
     * @param openFlags
     *            flags for open operation
     * @param access
     *            desired file access flags
     * @param sharing
     *            flags indicating for which operations others may open the file

        /**
         * Sets the ID of the updated item.
         * @param id The ID to set.
         * @return This ApiUpdateResponse instance.
         */
        public ApiUpdateResponse id(final String id) {
            this.id = id;
            return this;
        }

        /**
         * Sets whether the item was created or updated.
         * @param created True if created, false if updated.

        /**
         * Executes the filter logic on the given query.
         *
         * @param context the query context containing search parameters and state
         * @param query the Lucene query to be processed
         * @param boost the boost factor to apply to the query
         * @param chain the next filter chain to execute after this filter
         * @return the processed OpenSearch QueryBuilder
         */

 */
public class SuggestRequestBuilder extends RequestBuilder<SuggestRequest, SuggestResponse> {
    /**
     * Constructor for SuggestRequestBuilder.
     * @param client The OpenSearch client.
     * @param readingConverter The reading converter.
     * @param normalizer The normalizer.
     */
    public SuggestRequestBuilder(final Client client, final ReadingConverter readingConverter, final Normalizer normalizer) {

    /**
     * Writes setup data in wire format
     * @param dst destination buffer
     * @param dstIndex starting index in destination buffer
     * @return number of bytes written
     */
    protected abstract int writeSetupWireFormat(byte[] dst, int dstIndex);

    /**
     * Writes parameters in wire format
     * @param dst destination buffer
     * @param dstIndex starting index in destination buffer

    }

    /**
     * Constructs a PreauthIntegrityService with specified configuration.
     *
     * @param secureRandom the secure random generator
     * @param hashAlgorithm the hash algorithm to use
     * @param enforceIntegrity whether to enforce integrity checks
     */
    public PreauthIntegrityService(SecureRandom secureRandom, int hashAlgorithm, boolean enforceIntegrity) {

    /**
     * Creates a RequestHeader entity from form data with user and timestamp information.
     *
     * @param form the form containing the request header data
     * @param username the username of the user performing the operation
     * @param currentTime the current timestamp
     * @return optional entity containing the request header data, or empty if creation fails
     */

     * transformation has occurred the original artifact is returned.
     *
     * @param artifact           Artifact to be transformed.
     * @param remoteRepositories the repositories to check
     * @param localRepository    the local repository
     */
    void transformForResolve(

    //                                            ----------

    /**
     * Creates a new scheduled job from a crawler configuration.
     *
     * @param type the crawler type (web, file, or data)
     * @param id the crawler configuration ID
     * @param name the name for the new job (base64 encoded)
     * @return HTML response for the job creation form
     */
    @Execute
    @Secured({ ROLE })

    @Resource
    private StemmerOverrideService stemmerOverrideService;

    /**
     * Retrieves stemmer override dictionary settings with pagination support.
     *
     * @param dictId the dictionary ID
     * @param body the search body containing pagination and filter parameters
     * @return JSON response containing list of stemmer override dictionary items
     */