import { SamplingConfig, SamplingContext, SamplingDecision, SamplingRule } from "./types.mjs";
import { ReadableSpan } from "@opentelemetry/sdk-trace-base";

//#region src/sampling/runtime.d.ts
/**
 * Coordinates sampling decisions and buffered trace export.
 */
declare class SamplingController {
  #private;
  constructor(options?: {
    finalizedTraceTtlMs?: number;
  });
  /**
   * Resolves a user sampling callback into an executable sampling decision.
   */
  resolveDecision(sampling: SamplingConfig | undefined, samplingContext: SamplingContext): SamplingDecision;
  /**
   * Registers a trace whose spans should be buffered until the root span ends.
   */
  registerTrace(options: {
    traceId: string;
    rootSpanId: string;
    rule: SamplingRule;
    sampled: boolean;
  }): void;
  /**
   * Consumes an ended span and returns spans ready for export.
   *
   * Returns `undefined` when the trace is not sampling-managed, an empty array
   * when export should be delayed or dropped, and one or more spans when the
   * buffered trace should be forwarded.
   */
  consumeSpan(span: ReadableSpan): ReadableSpan[] | undefined;
  /**
   * Clears all buffered sampling state.
   */
  clear(): void;
}
/**
 * Process-wide sampling controller used by Monocle instrumentations.
 */
declare const defaultSamplingController: SamplingController;
/**
 * Resolves a user sampling callback using the default sampling controller.
 */
declare function resolveSamplingDecision(sampling: SamplingConfig | undefined, samplingContext: SamplingContext): SamplingDecision;
/**
 * Registers a trace in the default sampling controller.
 */
declare function registerSamplingTrace(options: {
  traceId: string;
  rootSpanId: string;
  rule: SamplingRule;
  sampled: boolean;
}): void;
/**
 * Consumes an ended span through the default sampling controller.
 */
declare function consumeSamplingSpan(span: ReadableSpan): ReadableSpan[] | undefined;
/**
 * Clears the default sampling controller.
 */
declare function clearSamplingTraces(): void;
//#endregion
export { SamplingController, clearSamplingTraces, consumeSamplingSpan, defaultSamplingController, registerSamplingTrace, resolveSamplingDecision };