import type { Event } from "../event.js";
import { type SubscriberDataAttribute } from "../instrument.js";
import { Level } from "../level.js";
import type { OpenTelemetrySubscriberData, SpanAttributes } from "../span.js";
import type { ISubscriber } from "../subscriber.js";
import { type Span, type Tracer } from "@opentelemetry/api";
export declare function otel(data: OpenTelemetrySubscriberData): SubscriberDataAttribute;
type SpanNode = {
    id: symbol;
    attributes: SpanAttributes;
};
type PendingSpanNode = SpanNode & {
    parent: undefined;
    otelSpan: undefined;
};
type EnteredSpanNode = SpanNode & {
    parent: EnteredSpanNode | undefined;
    otelSpan: Span;
};
/**
 * Options for the JsonSubscriber.
 */
export type OpenTelemetrySubscriberOptions = {
    /**
     * The minimum level of logs to display.
     *
     * @default Level.INFO
     */
    level?: Level;
    /**
     * The Open Telemetry tracer to use.
     *
     * @default trace.getTracer("default")
     */
    tracer?: Tracer;
};
/**
 * The OpenTelemetrySubscriber class is a subscriber which emits OpenTelemetry
 * spans and events.
 *
 * @example
 * ```ts
 * import { OpenTelemetrySubscriber } from "@bcheidemann/tracing";
 *
 * // Initialize the subscriber and set it as the default global subscriber
 * // This should be called at the beginning of your program
 * OpenTelemetrySubscriber.setGlobalDefault();
 * ```
 *
 * ## Usage Considerations
 *
 * ### OpenTelemetry Configuration
 *
 * The `OpenTelemetrySubscriber` will not automatically set up the OpenTelemetry
 * SDK. Ensure you have correctly set up OpenTelemetry correctly for your
 * runtime.
 *
 * - [Guidance for Node.js (and other Node.js compatible runtimes)](https://opentelemetry.io/docs/languages/js/getting-started/nodejs/)
 * - [Guidance for Deno (built in OpenTelemetry support)](https://docs.deno.com/runtime/fundamentals/open_telemetry/)
 *
 * ### Interfacing with OpenTelemetry Directly
 *
 * Due to the way span propogation works in OpenTelemetry, manually created
 * spans will not automatically propogate the current OpenTelemetry span to
 * code which interfaces directly with OpenTelemetry.
 *
 * ```ts
 * function main() {
 *   using _ = infoSpan("main");
 *   trace.getActiveSpan()?.addEvent("Oops!");
 * }
 * ```
 *
 * The above code does not work. Although "main" is considered the active span
 * by tracing, it has not been set as the active OpenTelemetry span. This is
 * not currently possible due to limitations of the OpenTelemetry JavaScript
 * API.
 *
 * To work around this limitation, it is recommended to use instrumented
 * callbacks and methods wherever possible:
 *
 * ```ts
 * const main = instrumentCallback(function main() {
 *   trace.getActiveSpan()?.addEvent("Success!");
 * });
 *
 * // Or...
 *
 * class App {
 *   @instrument() main() {
 *     trace.getActiveSpan()?.addEvent("Success!");
 *   }
 * }
 * ```
 *
 * Additionally, prefer to emit tracing events, instead of interfacing with
 * OpenTelemetry directly:
 *
 * ```ts
 * function main() {
 *   using _ = infoSpan("main");
 *   info("Success!");
 * }
 * ```
 *
 * The above code will ensure that the event is emitted for the correct span.
 *
 * If neither is possible, you must ensure that you use the `runInContext`
 * method, to explicitly set the current OpenTelemetry span.
 *
 * ```ts
 * function main() {
 *   using _ = infoSpan("main");
 *   getSubscriberContextOrThrow().subscriber.runInContext(function () {
 *     trace.getActiveSpan()?.addEvent("Success!");
 *   }, this, []);
 * }
 * ```
 *
 * The above code is automatically called when executing an instrumented method
 * or function. That's why it's recommended to avoid creating spans manually,
 * and instead rely on instrumentation wherever possible.
 */
export declare class OpenTelemetrySubscriber implements ISubscriber<symbol> {
    #private;
    private readonly _options;
    private _currentSpan;
    private readonly _spans;
    protected constructor(_options: OpenTelemetrySubscriberOptions, _currentSpan?: EnteredSpanNode | undefined, _spans?: WeakMap<symbol, PendingSpanNode | EnteredSpanNode>);
    static setGlobalDefault(options?: OpenTelemetrySubscriberOptions): OpenTelemetrySubscriber;
    enabledForLevel(level: Level): boolean;
    enabled(_metadata: Event | SpanAttributes): boolean;
    newSpan(attributes: SpanAttributes): symbol;
    event(event: Event): void;
    enter(span: symbol): void;
    exit(span: symbol): void;
    record(spanId: symbol, key: string, value: unknown): void;
    currentSpan(): symbol | undefined;
    clone(): ISubscriber<symbol>;
    runInContext<TThis, TArgs extends unknown[], TReturn>(callback: (this: TThis, ...args: TArgs) => TReturn, thisArg: TThis, args: TArgs): TReturn;
}
export {};
//# sourceMappingURL=OpenTelemetrySubscriber.d.ts.map