}
            return null;
        }).filter(StringUtil::isNotBlank).orElse(url);
    }

    /**
     * Gets the localized page path for a given page name.
     * Checks for locale-specific versions before falling back to default.
     *
     * @param page the page name
     * @return the localized page path
     */
    public String getPagePath(final String page) {

     * @return an optional containing the authenticated user if successful, empty otherwise
     */
    public OptionalEntity<FessUser> login(final String username, final String password) {
        // Add defensive null/blank checks
        if (StringUtil.isBlank(username) || StringUtil.isBlank(password)) {
            if (logger.isDebugEnabled()) {
                logger.debug("Login failed: username or password is blank");
            }

            return false;
        }
        return true;
    }

    /**
     * Validates if the canonical URL is valid relative to the original URL.
     * Specifically checks for HTTPS to HTTP downgrades.
     *
     * @param url the original URL
     * @param canonicalUrl the canonical URL to validate
     * @return true if the canonical URL is valid, false otherwise
     */

            assertEquals("0123456789", new String(buffer, 0, bytesRead, "UTF-8"));

            // Read next chunk
            bytesRead = in.read(buffer);
            assertEquals(10, bytesRead, "Should read next chunk");
            assertEquals("ABCDEFGHIJ", new String(buffer, 0, bytesRead, "UTF-8"));
        }
    }

    @Test

        }
        return split(value, ",").get(stream -> stream.filter(StringUtil::isNotBlank).map(String::trim).toArray(n -> new String[n]));
    }

    /**
     * Checks if domain services are enabled for Entra ID authentication.
     * Uses new entraid.use.ds key with fallback to legacy aad.use.ds.
     * @return true if domain services are enabled, false otherwise.
     */

search_engine.http.ssl.certificate_authorities=
# Username for authenticating to the search engine.
search_engine.username=
# Password for authenticating to the search engine.
search_engine.password=
# Interval (ms) for heartbeat checks to the search engine.
search_engine.heartbeat_interval=10000

# Cipher algorithm used for encryption.
app.cipher.algorism=aes
# Secret key for encryption (change this value for production).
app.cipher.key=___change__me___

    protected void closeResources(final HttpUriRequest httpRequest, final ResponseData responseData) {
        CloseableUtil.closeQuietly(responseData);
        httpRequest.abort();
    }

    /**
     * Checks if the HTTP status code indicates a redirect.
     *
     * @param httpStatusCode The HTTP status code to check
     * @return True if the status code indicates a redirect, false otherwise
     */

                }
                states.remove(state);
                return stateData;
            }
        }
        return null;
    }

    /**
     * Checks if the request contains authentication data from Entra ID.
     * @param request The HTTP servlet request to check.
     * @return True if authentication data is present, false otherwise.
     */