/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.apache.camel.quarkus.component.file.cluster;

import java.util.Map;
import java.util.Optional;
import java.util.function.BooleanSupplier;

import io.quarkus.runtime.annotations.ConfigPhase;
import io.quarkus.runtime.annotations.ConfigRoot;
import io.smallrye.config.ConfigMapping;
import io.smallrye.config.WithDefault;

@ConfigRoot(phase = ConfigPhase.BUILD_AND_RUN_TIME_FIXED)
@ConfigMapping(prefix = "quarkus.camel.cluster.file")
public interface FileLockClusterServiceConfig {
    /**
     * Whether a File Lock Cluster Service should be automatically configured according to
     * 'quarkus.camel.cluster.file.++*++' configurations.
     *
     * @deprecated  this property is no longer needed as the FileLock implementation of the Camel CLuster Service API has
     *              been moved to a dedicated extension.
     * @asciidoclet
     */
    @Deprecated(since = "3.10.0", forRemoval = true)
    @WithDefault("true")
    boolean enabled();

    /**
     * The cluster service ID (defaults to null).
     *
     * @asciidoclet
     */
    Optional<String> id();

    /**
     * The root path (defaults to null).
     *
     * @asciidoclet
     */
    Optional<String> root();

    /**
     * The service lookup order/priority (defaults to 2147482647).
     *
     * @asciidoclet
     */
    Optional<Integer> order();

    /**
     * The custom attributes associated to the service (defaults to empty map).
     *
     * @asciidoclet
     */
    Map<String, String> attributes();

    /**
     * The time to wait before starting to try to acquire the cluster lock. Note that if FileLockClusterService determines
     * no cluster members are running or cannot reliably determine the cluster state, the initial delay is computed from the
     * acquireLockInterval (defaults to 1000ms).
     *
     * @asciidoclet
     */
    Optional<String> acquireLockDelay();

    /**
     * The time to wait between attempts to try to acquire the cluster lock evaluated using wall-clock time. All cluster
     * members must use the same value so leadership checks and leader liveness detection remain consistent (defaults to
     * 10000ms).
     *
     * @asciidoclet
     */
    Optional<String> acquireLockInterval();

    /**
     * Multiplier applied to the cluster leader `acquireLockInterval` to determine how long followers should wait
     * before considering the leader "stale".
     *
     * For example, if the leader updates its heartbeat every 2 seconds and the `heartbeatTimeoutMultiplier` is `3`,
     * followers will tolerate up to `2s * 3 = 6s` of silence before declaring the leader unavailable.
     *
     * @asciidoclet
     */
    Optional<Integer> heartbeatTimeoutMultiplier();

    /**
     * Sets how many times a cluster data task will run, counting both the first execution and subsequent retries in
     * case of failure or timeout. The default is 5 attempts.
     *
     * This can be useful when the cluster data root is on network based file storage, where I/O operations may
     * occasionally block for long or unpredictable periods.
     *
     * @asciidoclet
     */
    Optional<Integer> clusterDataTaskMaxAttempts();

    /**
     * Sets the timeout for a cluster data task (reading or writing cluster data). The default is 10 seconds.
     *
     * Timeouts are useful when the cluster data root is on network storage, where I/O operations may occasionally block
     * for long or unpredictable periods.
     *
     * @asciidoclet
     */
    Optional<String> clusterDataTaskTimeout();

    final class Enabled implements BooleanSupplier {
        FileLockClusterServiceConfig config;

        @Override
        public boolean getAsBoolean() {
            return config.enabled();
        }
    }
}
