package io.prometheus.metrics.core.metrics;

import static java.util.Objects.requireNonNull;

import io.prometheus.metrics.annotations.StableApi;
import io.prometheus.metrics.config.MetricsProperties;
import io.prometheus.metrics.config.PrometheusProperties;
import io.prometheus.metrics.core.datapoints.DistributionDataPoint;
import io.prometheus.metrics.core.exemplars.ExemplarSampler;
import io.prometheus.metrics.core.exemplars.ExemplarSamplerConfig;
import io.prometheus.metrics.model.registry.MetricType;
import io.prometheus.metrics.model.snapshots.Exemplars;
import io.prometheus.metrics.model.snapshots.Labels;
import io.prometheus.metrics.model.snapshots.Quantile;
import io.prometheus.metrics.model.snapshots.Quantiles;
import io.prometheus.metrics.model.snapshots.SummarySnapshot;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.atomic.DoubleAdder;
import java.util.concurrent.atomic.LongAdder;
import java.util.function.Supplier;
import javax.annotation.Nullable;

/**
 * Summary metric. Example:
 *
 * <pre>{@code
 * Summary summary = Summary.builder()
 *         .name("http_request_duration_seconds_hi")
 *         .help("HTTP request service time in seconds")
 *         .unit(SECONDS)
 *         .labelNames("method", "path", "status_code")
 *         .quantile(0.5, 0.01)
 *         .quantile(0.95, 0.001)
 *         .quantile(0.99, 0.001)
 *         .register();
 *
 * long start = System.nanoTime();
 * // process a request, duration will be observed
 * summary.labelValues("GET", "/", "200").observe(Unit.nanosToSeconds(System.nanoTime() - start));
 * }</pre>
 *
 * See {@link Summary.Builder} for configuration options.
 */
@StableApi
public class Summary extends StatefulMetric<DistributionDataPoint, Summary.DataPoint>
    implements DistributionDataPoint {

  private final List<CKMSQuantiles.Quantile> quantiles; // May be empty, but cannot be null.

  private final long maxAgeSeconds;
  private final int ageBuckets;
  @Nullable private final ExemplarSamplerConfig exemplarSamplerConfig;
  @Nullable private final Supplier<Labels> exemplarLabelsSupplier;

  private Summary(Builder builder, PrometheusProperties prometheusProperties) {
    super(builder);
    MetricsProperties[] properties = getMetricProperties(builder, prometheusProperties);
    quantiles = Collections.unmodifiableList(makeQuantiles(properties));
    maxAgeSeconds = getConfigProperty(properties, MetricsProperties::getSummaryMaxAgeSeconds);
    ageBuckets = getConfigProperty(properties, MetricsProperties::getSummaryNumberOfAgeBuckets);
    boolean exemplarsEnabled =
        getConfigProperty(properties, MetricsProperties::getExemplarsEnabled);
    if (exemplarsEnabled) {
      exemplarSamplerConfig =
          new ExemplarSamplerConfig(prometheusProperties.getExemplarProperties(), 4);
    } else {
      exemplarSamplerConfig = null;
    }
    exemplarLabelsSupplier = builder.exemplarLabelsSupplier;
  }

  private List<CKMSQuantiles.Quantile> makeQuantiles(MetricsProperties[] properties) {
    List<CKMSQuantiles.Quantile> result = new ArrayList<>();
    List<Double> quantiles = getConfigProperty(properties, MetricsProperties::getSummaryQuantiles);
    List<Double> quantileErrors =
        getConfigProperty(properties, MetricsProperties::getSummaryQuantileErrors);
    if (quantiles != null) {
      for (int i = 0; i < quantiles.size(); i++) {
        if (quantileErrors.size() > 0) {
          result.add(new CKMSQuantiles.Quantile(quantiles.get(i), quantileErrors.get(i)));
        } else {
          result.add(
              new CKMSQuantiles.Quantile(quantiles.get(i), Builder.defaultError(quantiles.get(i))));
        }
      }
    }
    return result;
  }

  @Override
  public double getSum() {
    return getNoLabels().getSum();
  }

  @Override
  public long getCount() {
    return getNoLabels().getCount();
  }

  @Override
  public void observe(double amount) {
    getNoLabels().observe(amount);
  }

  @Override
  public void observeWithExemplar(double amount, Labels labels) {
    getNoLabels().observeWithExemplar(amount, labels);
  }

  @Override
  public SummarySnapshot collect() {
    return (SummarySnapshot) super.collect();
  }

  @Override
  protected SummarySnapshot collect(List<Labels> labels, List<DataPoint> metricData) {
    List<SummarySnapshot.SummaryDataPointSnapshot> data = new ArrayList<>(labels.size());
    for (int i = 0; i < labels.size(); i++) {
      data.add(metricData.get(i).collect(labels.get(i)));
    }
    return new SummarySnapshot(metadata, data);
  }

  /**
   * @deprecated Use {@link #getMetricFamilyDescriptor()} instead.
   */
  @Override
  @Deprecated
  @SuppressWarnings("InlineMeSuggester")
  public MetricType getMetricType() {
    return MetricType.SUMMARY;
  }

  @Override
  protected DataPoint newDataPoint() {
    return new DataPoint();
  }

  public class DataPoint implements DistributionDataPoint {

    private final LongAdder count = new LongAdder();
    private final DoubleAdder sum = new DoubleAdder();
    @Nullable private final SlidingWindow<CKMSQuantiles> quantileValues;
    private final Buffer buffer = new Buffer();
    @Nullable private final ExemplarSampler exemplarSampler;

    private final long createdTimeMillis = System.currentTimeMillis();

    private DataPoint() {
      if (quantiles.isEmpty()) {
        quantileValues = null;
      } else {
        CKMSQuantiles.Quantile[] quantilesArray = quantiles.toArray(new CKMSQuantiles.Quantile[0]);
        quantileValues =
            new SlidingWindow<>(
                CKMSQuantiles.class,
                () -> new CKMSQuantiles(quantilesArray),
                CKMSQuantiles::insert,
                maxAgeSeconds,
                ageBuckets);
      }
      if (exemplarSamplerConfig != null) {
        exemplarSampler = new ExemplarSampler(exemplarSamplerConfig, null, exemplarLabelsSupplier);
      } else {
        exemplarSampler = null;
      }
    }

    @Override
    public double getSum() {
      return sum.sum();
    }

    @Override
    public long getCount() {
      return count.sum();
    }

    @Override
    public void observe(double value) {
      if (Double.isNaN(value)) {
        return;
      }
      if (!buffer.append(value)) {
        doObserve(value);
      }
      if (exemplarSampler != null) {
        exemplarSampler.observe(value);
      }
    }

    @Override
    public void observeWithExemplar(double value, Labels labels) {
      if (Double.isNaN(value)) {
        return;
      }
      if (!buffer.append(value)) {
        doObserve(value);
      }
      if (exemplarSampler != null) {
        exemplarSampler.observeWithExemplar(value, labels);
      }
    }

    private void doObserve(double amount) {
      sum.add(amount);
      if (quantileValues != null) {
        quantileValues.observe(amount);
      }
      // count must be incremented last, because in collect() the count
      // indicates the number of completed observations.
      count.increment();
    }

    private SummarySnapshot.SummaryDataPointSnapshot collect(Labels labels) {
      return buffer.run(
          expectedCount -> count.sum() == expectedCount,
          // Note: Exemplars are currently hard-coded as empty for Summary metrics.
          // While exemplars are sampled during observe() and observeWithExemplar() calls
          // via the exemplarSampler field, they are not included in the snapshot to maintain
          // consistency with the buffering mechanism. The buffer.run() ensures atomic
          // collection of count, sum, and quantiles. Adding exemplars would require
          // coordination between the buffer and exemplarSampler, which could impact
          // performance. Consider using Histogram instead if exemplars are needed.
          () ->
              new SummarySnapshot.SummaryDataPointSnapshot(
                  count.sum(),
                  sum.sum(),
                  makeQuantiles(),
                  labels,
                  Exemplars.EMPTY,
                  createdTimeMillis),
          this::doObserve);
    }

    private List<CKMSQuantiles.Quantile> getQuantiles() {
      return quantiles;
    }

    private Quantiles makeQuantiles() {
      Quantile[] quantiles = new Quantile[getQuantiles().size()];
      for (int i = 0; i < getQuantiles().size(); i++) {
        CKMSQuantiles.Quantile quantile = getQuantiles().get(i);
        quantiles[i] =
            new Quantile(
                quantile.quantile, requireNonNull(quantileValues).current().get(quantile.quantile));
      }
      return Quantiles.of(quantiles);
    }
  }

  public static Summary.Builder builder() {
    return new Builder(PrometheusProperties.get());
  }

  public static Summary.Builder builder(PrometheusProperties config) {
    return new Builder(config);
  }

  public static class Builder extends StatefulMetric.Builder<Summary.Builder, Summary> {

    /** 5 minutes. See {@link #maxAgeSeconds(long)}. */
    public static final long DEFAULT_MAX_AGE_SECONDS = TimeUnit.MINUTES.toSeconds(5);

    /** 5. See {@link #numberOfAgeBuckets(int)} */
    public static final int DEFAULT_NUMBER_OF_AGE_BUCKETS = 5;

    private final List<CKMSQuantiles.Quantile> quantiles = new ArrayList<>();
    @Nullable private Long maxAgeSeconds;
    @Nullable private Integer ageBuckets;

    private Builder(PrometheusProperties properties) {
      super(Collections.singletonList("quantile"), properties);
    }

    private static double defaultError(double quantile) {
      if (quantile <= 0.01 || quantile >= 0.99) {
        return 0.001;
      } else if (quantile <= 0.02 || quantile >= 0.98) {
        return 0.005;
      } else {
        return 0.01;
      }
    }

    /**
     * Add a quantile. See {@link #quantile(double, double)}.
     *
     * <p>Default errors are:
     *
     * <ul>
     *   <li>error = 0.001 if quantile &lt;= 0.01 or quantile &gt;= 0.99
     *   <li>error = 0.005 if quantile &lt;= 0.02 or quantile &gt;= 0.98
     *   <li>error = 0.01 else.
     * </ul>
     */
    public Builder quantile(double quantile) {
      return quantile(quantile, defaultError(quantile));
    }

    /**
     * Add a quantile. Call multiple times to add multiple quantiles.
     *
     * <p>Example: The following will track the 0.95 quantile:
     *
     * <pre>{@code
     * .quantile(0.95, 0.001)
     * }</pre>
     *
     * The second argument is the acceptable error margin, i.e. with the code above the quantile
     * will not be exactly the 0.95 quantile but something between 0.949 and 0.951.
     *
     * <p>There are two special cases:
     *
     * <ul>
     *   <li>{@code .quantile(0.0, 0.0)} gives you the minimum observed value
     *   <li>{@code .quantile(1.0, 0.0)} gives you the maximum observed value
     * </ul>
     */
    public Builder quantile(double quantile, double error) {
      if (quantile < 0.0 || quantile > 1.0) {
        throw new IllegalArgumentException(
            "Quantile " + quantile + " invalid: Expected number between 0.0 and 1.0.");
      }
      if (error < 0.0 || error > 1.0) {
        throw new IllegalArgumentException(
            "Error " + error + " invalid: Expected number between 0.0 and 1.0.");
      }
      quantiles.add(new CKMSQuantiles.Quantile(quantile, error));
      return this;
    }

    /**
     * The quantiles are relative to a moving time window. {@code maxAgeSeconds} is the size of that
     * time window. Default is {@link #DEFAULT_MAX_AGE_SECONDS}.
     */
    public Builder maxAgeSeconds(long maxAgeSeconds) {
      if (maxAgeSeconds <= 0) {
        throw new IllegalArgumentException("maxAgeSeconds cannot be " + maxAgeSeconds);
      }
      this.maxAgeSeconds = maxAgeSeconds;
      return this;
    }

    /**
     * The quantiles are relative to a moving time window. The {@code numberOfAgeBuckets} defines
     * how smoothly the time window moves forward. For example, if the time window is 5 minutes and
     * has 5 age buckets, then it is moving forward every minute by one minute. Default is {@link
     * #DEFAULT_NUMBER_OF_AGE_BUCKETS}.
     */
    public Builder numberOfAgeBuckets(int ageBuckets) {
      if (ageBuckets <= 0) {
        throw new IllegalArgumentException("ageBuckets cannot be " + ageBuckets);
      }
      this.ageBuckets = ageBuckets;
      return this;
    }

    @Override
    protected MetricsProperties toProperties() {
      double[] quantiles = null;
      double[] quantileErrors = null;
      if (!this.quantiles.isEmpty()) {
        quantiles = new double[this.quantiles.size()];
        quantileErrors = new double[this.quantiles.size()];
        for (int i = 0; i < this.quantiles.size(); i++) {
          quantiles[i] = this.quantiles.get(i).quantile;
          quantileErrors[i] = this.quantiles.get(i).epsilon;
        }
      }
      MetricsProperties.Builder builder = MetricsProperties.builder();
      if (quantiles != null) {
        builder.summaryQuantiles(quantiles);
      }
      if (quantileErrors != null) {
        builder.summaryQuantileErrors(quantileErrors);
      }
      return builder
          .exemplarsEnabled(exemplarsEnabled)
          .summaryNumberOfAgeBuckets(ageBuckets)
          .summaryMaxAgeSeconds(maxAgeSeconds)
          .build();
    }

    /** Default properties for summary metrics. */
    @Override
    public MetricsProperties getDefaultProperties() {
      return MetricsProperties.builder()
          .exemplarsEnabled(true)
          .summaryQuantiles()
          .summaryNumberOfAgeBuckets(DEFAULT_NUMBER_OF_AGE_BUCKETS)
          .summaryMaxAgeSeconds(DEFAULT_MAX_AGE_SECONDS)
          .build();
    }

    @Override
    public Summary build() {
      return new Summary(this, properties);
    }

    @Override
    protected Builder self() {
      return this;
    }
  }
}