/*
 * 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.core;

import java.time.Duration;
import java.util.List;
import java.util.Optional;

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

@ConfigRoot(phase = ConfigPhase.BUILD_AND_RUN_TIME_FIXED)
@ConfigMapping(prefix = "quarkus.camel")
public interface CamelConfig {
    enum FailureRemedy {
        fail, warn, ignore
    }

    /**
     * Build time configuration options for Camel services.
     *
     * @asciidoclet
     */
    ServiceConfig service();

    /**
     * Build time configuration options for `org.apache.camel.catalog.RuntimeCamelCatalog`.
     *
     * @asciidoclet
     */
    RuntimeCatalogConfig runtimeCatalog();

    /**
     * Build time configuration options for routes discovery.
     *
     * @asciidoclet
     */
    RoutesDiscoveryConfig routesDiscovery();

    /**
     * Build time configuration options related to the building of native executable.
     *
     * @asciidoclet
     */
    @WithName("native")
    NativeConfig native_();

    /**
     * Build time configuration options for the Camel CSimple language.
     *
     * @asciidoclet
     */
    @Deprecated(forRemoval = true)
    CSimpleConfig csimple();

    /**
     * Build time configuration options for the extraction of Camel expressions.
     *
     * @asciidoclet
     */
    ExpressionConfig expression();

    /**
     * Build time configuration options for the Camel CDI event bridge.
     *
     * @asciidoclet
     */
    EventBridgeConfig eventBridge();

    /**
     * Build time configuration options for enable/disable camel source location.
     *
     * @asciidoclet
     */
    @WithDefault("false")
    boolean sourceLocationEnabled();

    /**
     * Build time configuration options for the Camel tracing.
     *
     * @deprecated  use the standard Apache Camel {@code camel.trace.*} configuration properties instead. Deprecated in
     *              3.39.0,
     *              will be removed in 4.0.0.
     * @asciidoclet
     */
    @Deprecated(since = "3.39.0", forRemoval = true)
    TraceConfig trace();

    /**
     * Build time configuration options for Camel type converters.
     *
     * @deprecated  use the standard Apache Camel {@code camel.main.typeConverterStatisticsEnabled} configuration property
     *              instead. Deprecated in 3.39.0, will be removed in 4.0.0.
     * @asciidoclet
     */
    @Deprecated(since = "3.39.0", forRemoval = true)
    TypeConverterConfig typeConverter();

    /**
     * Build time configuration options for the Camel Quarkus Dev UI.
     *
     * @asciidoclet
     */
    DevUIConfig devUI();

    interface RoutesDiscoveryConfig {
        /**
         * Enable automatic discovery of routes during static initialization.
         *
         * @asciidoclet
         */
        @Deprecated(since = "3.26.0", forRemoval = true)
        @WithDefault("true")
        boolean enabled();

        /**
         * Used for exclusive filtering scanning of RouteBuilder classes. The exclusive filtering takes precedence over
         * inclusive filtering. The pattern is using Ant-path style pattern. Multiple patterns can be specified separated by
         * comma. For example to exclude all classes starting with Bar use: ++**++/Bar++*++ To exclude all routes from a
         * specific package use: com/mycompany/bar/++*++ To exclude all routes from a specific package and its sub-packages use
         * double wildcards: com/mycompany/bar/++**++ And to exclude all routes from two specific packages use:
         * com/mycompany/bar/++*++,com/mycompany/stuff/++*++
         *
         * @asciidoclet
         */
        Optional<List<String>> excludePatterns();

        /**
         * Used for inclusive filtering scanning of RouteBuilder classes. The exclusive filtering takes precedence over
         * inclusive filtering. The pattern is using Ant-path style pattern. Multiple patterns can be specified separated by
         * comma. For example to include all classes starting with Foo use: ++**++/Foo++*++ To include all routes from a
         * specific package use: com/mycompany/foo/++*++ To include all routes from a specific package and its sub-packages use
         * double wildcards: com/mycompany/foo/++**++ And to include all routes from two specific packages use:
         * com/mycompany/foo/++*++,com/mycompany/stuff/++*++
         *
         * @asciidoclet
         */
        Optional<List<String>> includePatterns();
    }

    interface ServiceConfig {
        /**
         * Build time configuration related to discoverability of Camel services via the `org.apache.camel.spi.FactoryFinder`
         * mechanism
         *
         * @asciidoclet
         */
        ServiceDiscoveryConfig discovery();

        /**
         * Build time configuration related to registering of Camel services to the Camel registry
         *
         * @asciidoclet
         */
        ServiceRegistryConfig registry();
    }

    interface ServiceDiscoveryConfig {
        /**
         * A comma-separated list of Ant-path style patterns to match Camel service definition files in the classpath. The
         * services defined in the matching files will *not* be discoverable via the **`org.apache.camel.spi.FactoryFinder`
         * mechanism.
         *
         * The excludes have higher precedence than includes. The excludes defined here can also be used to veto the
         * discoverability of services included by Camel Quarkus extensions.
         *
         * Example values: `META-INF/services/org/apache/camel/foo/++*++,META-INF/services/org/apache/camel/foo/++**++/bar`
         *
         * @asciidoclet
         */
        Optional<List<String>> excludePatterns();

        /**
         * A comma-separated list of Ant-path style patterns to match Camel service definition files in the classpath. The
         * services defined in the matching files will be discoverable via the `org.apache.camel.spi.FactoryFinder` mechanism
         * unless the given file is excluded via `exclude-patterns`.
         *
         * Note that Camel Quarkus extensions may include some services by default. The services selected here added to those
         * services and the exclusions defined in `exclude-patterns` are applied to the union set.
         *
         * Example values: `META-INF/services/org/apache/camel/foo/++*++,META-INF/services/org/apache/camel/foo/++**++/bar`
         *
         * @asciidoclet
         */
        Optional<List<String>> includePatterns();
    }

    interface ServiceRegistryConfig {
        /**
         * A comma-separated list of Ant-path style patterns to match Camel service definition files in the classpath. The
         * services defined in the matching files will *not* be added to Camel registry during application's static
         * initialization.
         *
         * The excludes have higher precedence than includes. The excludes defined here can also be used to veto the
         * registration of services included by Camel Quarkus extensions.
         *
         * Example values: `META-INF/services/org/apache/camel/foo/++*++,META-INF/services/org/apache/camel/foo/++**++/bar`**
         *
         * @asciidoclet
         */
        Optional<List<String>> excludePatterns();

        /**
         * A comma-separated list of Ant-path style patterns to match Camel service definition files in the classpath. The
         * services defined in the matching files will be added to Camel registry during application's static initialization
         * unless the given file is excluded via `exclude-patterns`.
         *
         * Note that Camel Quarkus extensions may include some services by default. The services selected here added to those
         * services and the exclusions defined in `exclude-patterns` are applied to the union set.
         *
         * Example values: `META-INF/services/org/apache/camel/foo/++*++,META-INF/services/org/apache/camel/foo/++**++/bar`
         *
         * @asciidoclet
         */
        Optional<List<String>> includePatterns();
    }

    interface NativeConfig {
        /**
         * Register classes for reflection.
         *
         * @asciidoclet
         */
        ReflectionConfig reflection();
    }

    interface ReflectionConfig {
        /**
         * A comma separated list of Ant-path style patterns to match class names that should be *excluded* from registering for
         * reflection. Use the class name format as returned by the `java.lang.Class.getName()` method: package segments
         * delimited by period `.` and inner classes by dollar sign `$`.
         *
         * This option narrows down the set selected by `include-patterns`. By default, no classes are excluded.
         *
         * This option cannot be used to unregister classes which have been registered internally by Quarkus extensions.
         *
         * @asciidoclet
         */
        Optional<List<String>> excludePatterns();

        /**
         * A comma separated list of Ant-path style patterns to match class names that should be registered for reflection. Use
         * the class name format as returned by the `java.lang.Class.getName()` method: package segments delimited by period `.`
         * and inner classes by dollar sign `$`.
         *
         * By default, no classes are included. The set selected by this option can be narrowed down by `exclude-patterns`.
         *
         * Note that Quarkus extensions typically register the required classes for reflection by themselves. This option is
         * useful in situations when the built in functionality is not sufficient.
         *
         * Note that this option enables the full reflective access for constructors, fields and methods. If you need a finer
         * grained control, consider using `io.quarkus.runtime.annotations.RegisterForReflection` annotation in your Java code.
         *
         * For this option to work properly, at least one of the following conditions must be satisfied:
         *
         * - There are no wildcards (`++*++` or `/`) in the patterns
         * - The artifacts containing the selected classes contain a Jandex index (`META-INF/jandex.idx`)
         * - The artifacts containing the selected classes are registered for indexing using the
         * `quarkus.index-dependency.++*++` family of options in `application.properties` - e.g.
         *
         * [source,properties]
         * ----
         * quarkus.index-dependency.my-dep.group-id = org.my-group
         * quarkus.index-dependency.my-dep.artifact-id = my-artifact
         * ----
         *
         * where `my-dep` is a label of your choice to tell Quarkus that `org.my-group` and with `my-artifact` belong together.
         *
         * @asciidoclet
         */
        public Optional<List<String>> includePatterns();

        /**
         * If `true`, basic classes are registered for serialization; otherwise basic classes won't be registered automatically
         * for serialization in native mode. The list of classes automatically registered for serialization can be found in
         * link:https://github.com/apache/camel-quarkus/blob/main/extensions-core/core/deployment/src/main/java/org/apache/camel/quarkus/core/deployment/CamelSerializationProcessor.java[CamelSerializationProcessor.BASE_SERIALIZATION_CLASSES].
         * Setting this to `false` helps to reduce the size of the native image. In JVM mode, there is no real benefit of
         * setting this flag to `true` except for making the behavior consistent with native mode.
         *
         * @asciidoclet
         */
        @WithDefault("false")
        boolean serializationEnabled();
    }

    interface RuntimeCatalogConfig {
        /**
         * If `true` the Runtime Camel Catalog embedded in the application will contain JSON schemas of Camel components
         * available in the application; otherwise component JSON schemas will not be available in the Runtime Camel Catalog and
         * any attempt to access those will result in a RuntimeException.
         *
         * Setting this to `false` helps to reduce the size of the native image. In JVM mode, there is no real benefit of
         * setting this flag to `false` except for making the behavior consistent with native mode.
         *
         * @asciidoclet
         */
        @WithDefault("true")
        boolean components();

        /**
         * If `true` the Runtime Camel Catalog embedded in the application will contain JSON schemas of Camel languages
         * available in the application; otherwise language JSON schemas will not be available in the Runtime Camel Catalog and
         * any attempt to access those will result in a RuntimeException.
         *
         * Setting this to `false` helps to reduce the size of the native image. In JVM mode, there is no real benefit of
         * setting this flag to `false` except for making the behavior consistent with native mode.
         *
         * @asciidoclet
         */
        @WithDefault("true")
        boolean languages();

        /**
         * If `true` the Runtime Camel Catalog embedded in the application will contain JSON schemas of Camel data formats
         * available in the application; otherwise data format JSON schemas will not be available in the Runtime Camel Catalog
         * and any attempt to access those will result in a RuntimeException.
         *
         * Setting this to `false` helps to reduce the size of the native image. In JVM mode, there is no real benefit of
         * setting this flag to `false` except for making the behavior consistent with native mode.
         *
         * @asciidoclet
         */
        @WithDefault("true")
        boolean dataformats();

        /**
         * If `true` the Runtime Camel Catalog embedded in the application will contain JSON schemas of Camel dev consoles
         * available in the application; otherwise dev console JSON schemas will not be available in the Runtime Camel Catalog
         * and any attempt to access those will result in a RuntimeException.
         *
         * Setting this to `false` helps to reduce the size of the native image. In JVM mode, there is no real benefit of
         * setting this flag to `false` except for making the behavior consistent with native mode.
         *
         * @asciidoclet
         */
        @WithDefault("true")
        boolean devconsoles();

        /**
         * If `true` the Runtime Camel Catalog embedded in the application will contain JSON schemas of Camel EIP models
         * available in the application; otherwise EIP model JSON schemas will not be available in the Runtime Camel Catalog and
         * any attempt to access those will result in a RuntimeException.
         *
         * Setting this to `false` helps to reduce the size of the native image. In JVM mode, there is no real benefit of
         * setting this flag to `false` except for making the behavior consistent with native mode.
         *
         * @asciidoclet
         */
        @WithDefault("true")
        boolean models();

        /**
         * If `true` the Runtime Camel Catalog embedded in the application will contain JSON schemas of Camel transformers
         * available in the application; otherwise transformer JSON schemas will not be available in the Runtime Camel Catalog
         * and any attempt to access those will result in a RuntimeException.
         *
         * Setting this to `false` helps to reduce the size of the native image. In JVM mode, there is no real benefit of
         * setting this flag to `false` except for making the behavior consistent with native mode.
         *
         * @asciidoclet
         */
        @WithDefault("true")
        boolean transformers();
    }

    /**
     * @deprecated use {@link ExpressionConfig} instead
     */
    @Deprecated(forRemoval = true)
    interface CSimpleConfig {
        /**
         * What to do if it is not possible to extract CSimple expressions from a route definition at build time.
         *
         * @asciidoclet
         */
        @WithDefault("warn")
        FailureRemedy onBuildTimeAnalysisFailure();
    }

    interface ExpressionConfig {
        /**
         * What to do if it is not possible to extract expressions from a route definition at build time.
         *
         * @asciidoclet
         */
        @WithDefault("warn")
        FailureRemedy onBuildTimeAnalysisFailure();

        /**
         * Indicates whether the expression extraction from the route definitions at build time must be done. If disabled, the
         * expressions are compiled at runtime.
         *
         * @asciidoclet
         */
        @WithDefault("true")
        boolean extractionEnabled();
    }

    interface EventBridgeConfig {
        /**
         * Whether to enable the bridging of Camel events to CDI events.
         *
         * This allows CDI observers to be configured for Camel events. E.g. those belonging to the
         * `org.apache.camel.quarkus.core.events`, `org.apache.camel.quarkus.main.events` & `org.apache.camel.impl.event`
         * packages.
         *
         * Note that this configuration item only has any effect when observers configured for Camel events are present in the
         * application.
         *
         * @asciidoclet
         */
        @WithDefault("true")
        boolean enabled();
    }

    /**
     * @deprecated use the standard Apache Camel {@code camel.trace.*} configuration properties instead. Deprecated in
     *             3.39.0,
     *             will be removed in 4.0.0.
     */
    @Deprecated(since = "3.39.0", forRemoval = true)
    interface TraceConfig {
        /**
         * Enables tracer in your Camel application.
         *
         * @asciidoclet
         */
        @WithDefault("false")
        boolean enabled();

        /**
         * To set the tracer in standby mode, where the tracer will be installed, but not automatically enabled. The tracer can
         * then be enabled explicitly later from Java, JMX or tooling.
         *
         * @asciidoclet
         */
        @WithDefault("false")
        boolean standby();

        /**
         * Defines how many of the last messages to keep in the tracer.
         *
         * @asciidoclet
         */
        @WithDefault("1000")
        int backlogSize();

        /**
         * Whether all traced messages should be removed when the tracer is dumping. By default, the messages are removed, which
         * means that dumping will not contain previous dumped messages.
         *
         * @asciidoclet
         */
        @WithDefault("true")
        boolean removeOnDump();

        /**
         * To limit the message body to a maximum size in the traced message. Use 0 or negative value to use unlimited size.
         *
         * @asciidoclet
         */
        @WithDefault("131072")
        int bodyMaxChars();

        /**
         * Whether to include the message body of stream based messages. If enabled then beware the stream may not be
         * re-readable later. See more about Stream Caching.
         *
         * @asciidoclet
         */
        @WithDefault("false")
        boolean bodyIncludeStreams();

        /**
         * Whether to include the message body of file based messages. The overhead is that the file content has to be read from
         * the file.
         *
         * @asciidoclet
         */
        @WithDefault("true")
        boolean bodyIncludeFiles();

        /**
         * Whether to include the exchange properties in the traced message.
         *
         * @asciidoclet
         */
        @WithDefault("true")
        boolean includeExchangeProperties();

        /**
         * Whether to include the exchange variables in the traced message.
         *
         * @asciidoclet
         */
        @WithDefault("true")
        boolean includeExchangeVariables();

        /**
         * Whether to include the exception in the traced message in case of failed exchange.
         *
         * @asciidoclet
         */
        @WithDefault("true")
        boolean includeException();

        /**
         * Whether to trace routes that is created from Rest DSL.
         *
         * @asciidoclet
         */
        @WithDefault("false")
        boolean traceRests();

        /**
         * Whether to trace routes that is created from route templates or kamelets.
         *
         * @asciidoclet
         */
        @WithDefault("false")
        boolean traceTemplates();

        /**
         * Filter for tracing by route or node id.
         *
         * @asciidoclet
         */
        Optional<String> tracePattern();

        /**
         * Filter for tracing messages.
         *
         * @asciidoclet
         */
        Optional<String> traceFilter();

        /**
         * Whether activity tracking is enabled. Activity tracking captures a rolling window of completed exchange
         * summaries with enriched span decorator attributes (e.g. Kafka topic, HTTP method, SQL query).
         *
         * @asciidoclet
         */
        @WithDefault("false")
        boolean activityEnabled();

        /**
         * The maximum number of completed exchange summaries to keep in the activity queue. The valid range is 1 to
         * 1000.
         *
         * @asciidoclet
         */
        @WithDefault("100")
        int activitySize();
    }

    /**
     * @deprecated use the standard Apache Camel {@code camel.main.typeConverterStatisticsEnabled} configuration property
     *             instead. Deprecated in 3.39.0, will be removed in 4.0.0.
     */
    @Deprecated(since = "3.39.0", forRemoval = true)
    interface TypeConverterConfig {
        /**
         * Whether type converter statistics are enabled. By default, type converter utilization statistics are disabled. Note
         * that enabling statistics incurs a minor performance impact under very heavy load.
         *
         * @asciidoclet
         */
        @WithDefault("false")
        boolean statisticsEnabled();
    }

    interface DevUIConfig {
        /**
         * The interval at which data is updated in Camel Quarkus Dev UI pages.
         *
         * @asciidoclet
         */
        @WithDefault("5S")
        Duration updateInterval();
    }
}
