}

    /**
     * Indexes a document asynchronously.
     *
     * @param request the index request
     * @return a future for the index response
     */
    @Override
    public ActionFuture<IndexResponse> index(final IndexRequest request) {
        return client.index(request);
    }

    /**
     * Indexes a document asynchronously with a callback.
     *

        } catch (final Exception e) {
            throw new SuggestIndexException("Failed to index from query_string.", e);
        }
    }

    /**
     * Indexes documents from a query log reader asynchronously.
     * @param queryLogReader The query log reader.
     * @param docPerReq The number of documents to process per request.
     * @param requestInterval The interval between requests.

        TemporaryFileInputStream stream = new TemporaryFileInputStream(tempFile);
        stream.read(); // Read some data
        stream.close();

        // Note: FileUtil.deleteInBackground() performs deletion asynchronously,
        // so we cannot reliably check if file is deleted immediately
        // This test just verifies that close() completes without error
    }

    public void test_emptyFile() throws Exception {

        }
        saveInfo(messages -> messages.addSuccessBulkProcessStarted(GLOBAL));
        return redirect(getClass()); // no-op
    }

    /**
     * Import the file asynchronously.
     * @param fileName The file name.
     * @param tempFile The temporary file.
     */
    protected void asyncImport(final String fileName, final File tempFile) {
        final int fileType;

        }
        load();
    }

    /**
     * Updates the processor configuration by reloading available searchers.
     * This method executes the load operation asynchronously in a separate thread.
     */
    public void update() {
        CommonPoolUtil.execute(this::load);
    }

    /**
     * Loads the available searcher names from system properties.

    }

    /**
     * Updates the user's group and role membership information with lazy loading for parent groups.
     * Direct groups are retrieved synchronously, while parent groups are fetched asynchronously
     * to avoid login delays when users have many nested group memberships.
     * @param user The Entra ID user to update.
     */
    public void updateMemberOf(final EntraIdUser user) {

     */
    @Override
    public ActionFuture<IndexResponse> index(final IndexRequest request) {
        return client.index(request);
    }

    /**
     * Executes an index request asynchronously.
     *
     * @param request The index request.
     * @param listener The response listener.
     */
    @Override

- Support for query parameters, headers, body (String or stream), compression, SSL configuration, proxies, and timeouts
- Automatic in-memory or on-disk caching of request/response bodies
- Synchronous and asynchronous (callback) execution
- Minimal dependencies (only Apache Commons IO)

## Installation

### Maven

Add the dependency to your `pom.xml` (replace `x.y.z` with the latest version):

```xml
<dependency>

            this.roles = roles;
        }

        /**
         * Resets permissions to force recalculation on next getPermissions() call.
         * This is called after asynchronous parent group lookup completes.
         */
        public void resetPermissions() {
            this.permissions = null;
        }
    }

3. **Resource Management**: `CurlResponse` implements `Closeable` for try-with-resources
4. **Async Support**: Both synchronous (`executeSync()`) and asynchronous (`execute()`) execution modes

## Technical Details

- **Java Version**: 17+
- **Dependencies**:
  - Apache Commons IO 2.19.0 (runtime)
  - JUnit 4.13.2 (test)
- **Module Name**: `org.codelibs.curl4j`