}

    /**
     * Gets the recommended heartbeat interval.
     *
     * @return the recommended heartbeat interval in milliseconds
     */
    public long getRecommendedHeartbeatInterval() {
        return recommendedHeartbeatInterval;
    }

    /**
     * Sets the recommended heartbeat interval.
     *
     * @param recommendedHeartbeatInterval the recommended heartbeat interval in milliseconds
     */

     */
    public void setResponseSequenceNumber(long responseSequenceNumber) {
        this.responseSequenceNumber = responseSequenceNumber;
    }

    /**
     * Gets the heartbeat interval recommended by the server (in milliseconds).
     * The client can use this to adjust the heartbeat frequency.
     *
     * @return the heartbeat interval in milliseconds
     */
    public long getHeartbeatInterval() {

    }

    /**
     * Checks if retry should be attempted
     *
     * @return true if retry is recommended
     */
    public boolean shouldRetry() {
        return severity == Severity.RECOVERABLE || severity == Severity.TRANSIENT;
    }

    /**
     * Gets recommended retry delay in milliseconds
     *
     * @return retry delay or 0 if no retry
     */
    public long getRetryDelay() {

        return false;
    }

    /**
     * Check if error suggests fallback to TCP is needed
     *
     * @param error the error to check
     * @return true if TCP fallback is recommended
     */
    public boolean shouldFallbackToTcp(Exception error) {
        // Hardware errors suggest RDMA is not working
        if (error.getMessage() != null) {

     */
    private DirectoryLeaseState() {
        // Utility class - prevent instantiation
    }

    /**
     * Directory Read and Handle caching (RH) - recommended for directory operations
     */
    public static final int DIRECTORY_READ_HANDLE = Smb2LeaseState.SMB2_LEASE_READ_CACHING | Smb2LeaseState.SMB2_LEASE_HANDLE_CACHING;

    /**

**Endpoints**:
- `GET /api/v1/documents?q={query}` (recommended)
- `GET /json/?q={query}` (legacy, for backward compatibility)

**Parameters**:
- `q` - Query string
- `num` - Results per page (default: 20)
- `start` - Starting offset (default: 0)
- `fields.label` - Label filter
- `lang` - Language preference

**Example**:
```bash
# Using the recommended endpoint

- **JUnit 4**: Testing framework
- **Maven**: Build and dependency management

## Quick Start

### Prerequisites

- Java 21 or higher
- OpenSearch/Elasticsearch cluster (2.x+ recommended)
- Maven 3.8+ for building from source

### Installation

Add the dependency to your `pom.xml`:

```xml
<dependency>
    <groupId>org.codelibs.fess</groupId>
    <artifactId>fess-suggest</artifactId>

            response.setReturnCode(message.getReturnCode());
            response.setSequenceNumber(message.getResponseSequenceNumber());

            if (message.isSuccess()) {
                // Set recommended heartbeat interval from server
                response.setRecommendedHeartbeatInterval(message.getHeartbeatInterval());
                log.debug("Witness heartbeat successful, next interval: {} ms", message.getHeartbeatInterval());

 * For production or when the IdP is configured with a different URL, you should
 * set one of the following:</p>
 *
 * <h3>Option 1: Set base URL (recommended for simplicity)</h3>
 * <pre>
 * # All SP URLs will be derived from this base URL
 * saml.sp.base.url=https://your-fess-server.example.com
 * </pre>
 *
 * <h3>Option 2: Set individual SP URLs</h3>
 * <pre>

                // This sends credentials in Base64 encoding over potentially unencrypted connections.
                // For production, it is STRONGLY RECOMMENDED to set spnego.allow.unsecure.basic to false
                // and use HTTPS or more secure authentication methods.
                return getProperty(SPNEGO_ALLOW_UNSECURE_BASIC, "true");
            }