import { IMidwayContainer } from '@midwayjs/core';
import { type ClzInstance, type Context, type DecoratorExecutorParamBase, type GrpcContext, Application } from '@mwcp/share';
import { Context as TraceContext, Span, SpanOptions, TimeInput } from '@opentelemetry/api';
import type { MethodTypeUnknown } from '@waiting/shared-types';
import { OtelComponent } from '../component.js';
import { type Config, type MiddlewareConfig, type SpanStatusOptions, AttrNames, TraceScopeType } from '../types.js';
import { TraceServiceSpan } from './trace.service.span.js';
import type { DecoratorTraceDataResp, DecoratorTraceDataRespAsync } from './trace.service.types.js';
export declare class TraceService extends TraceServiceSpan {
    readonly app: Application;
    readonly applicationContext: IMidwayContainer;
    readonly config: Config;
    readonly mwConfig: MiddlewareConfig;
    readonly otel: OtelComponent;
    init(): Promise<void>;
    startOnRequest(webCtx: Context): Promise<TraceContext | undefined>;
    /**
     * Finish the root span and clean the context.
     */
    finish(webCtx: Application | Context | GrpcContext, spanStatusOptions?: SpanStatusOptions, endTime?: TimeInput): void;
    protected startOnInit(webApplication: Application): Promise<void>;
    protected initRootSpan(scope: Context): TraceContext;
    protected genRootSpanName(scope: Context): string;
}
export interface GenDecoratorExecutorOptions {
    config: Config;
    traceService: TraceService;
}
export type ExecutorParamBase<T extends TraceDecoratorOptions = TraceDecoratorOptions> = DecoratorExecutorParamBase<T>;
export type DecoratorExecutorParam<T extends TraceDecoratorOptions = TraceDecoratorOptions> = ExecutorParamBase<T> & GenDecoratorExecutorOptions & {
    readonly rootTraceContext: TraceContext;
    callerAttr: {
        [AttrNames.CallerClass]: string;
        [AttrNames.CallerMethod]: string;
    };
    spanName: string;
    spanOptions: Partial<SpanOptions>;
    startActiveSpan: boolean;
    traceContext: TraceContext | undefined;
    traceScope: TraceScopeType | undefined;
    span: Span | undefined;
};
export type TraceOptions<M extends MethodTypeUnknown | undefined = undefined> = Partial<TraceDecoratorOptions<M>> | string;
export interface TraceDecoratorOptions<
/** Decorated method */
M extends MethodTypeUnknown | undefined = undefined, 
/** Arguments of decorated method */
MParamType = M extends MethodTypeUnknown<infer P> ? P : unknown[], MResultType = M extends MethodTypeUnknown<any[], infer R> ? R : unknown, MThis = unknown extends ThisParameterType<M> ? ClzInstance : ThisParameterType<M>> extends SpanOptions {
    /** @default `{target.name}/{methodName}` */
    spanName: string | KeyGenerator<MThis, MParamType> | undefined;
    /**
     * @default true
     */
    startActiveSpan: boolean;
    traceContext: TraceContext | undefined;
    /**
     * Used as the prefix of the span name,
     * if spanName is not provided,
     *   and the Caller ClassName is `AutoConfiguration` | `ContainerConfiguration`,
     *   and the Caller MethodName is event name, such as `onReady` | `onServerReady`,
     */
    namespace: string | undefined;
    /**
     * @default `/`
     */
    spanNameDelimiter: string | undefined;
    before: MethodTypeUnknown<[
        MParamType,
        DecoratorContext<MThis>
    ], // input args
    // input args
    DecoratorTraceDataResp | DecoratorTraceDataRespAsync, // output data
    ThisParameterType<M>> | undefined;
    after: MethodTypeUnknown<[
        MParamType,
        Awaited<MResultType>,
        DecoratorContext<MThis>
    ], // input args
    // input args
    DecoratorTraceDataResp | DecoratorTraceDataRespAsync, // output data
    ThisParameterType<M>> | undefined;
    afterThrow: MethodTypeUnknown<[
        MParamType,
        Error,
        DecoratorContext<MThis>
    ], // input args
    // input args
    DecoratorTraceDataResp | DecoratorTraceDataRespAsync, // output data
    ThisParameterType<M>> | undefined;
    /**
     * @default true
     */
    autoEndSpan: boolean | undefined;
}
export type KeyGenerator<TThis = any, ArgsType = unknown[], DContext extends DecoratorContext = DecoratorContext> = (this: TThis, 
/** Arguments of the method */
args: ArgsType, context: DContext) => string | undefined;
export type ScopeGenerator<TThis = any, ArgsType = unknown[], DContext extends DecoratorContextBase = DecoratorContextBase> = (this: TThis, 
/** Arguments of the method */
args: ArgsType, context: DContext) => object | symbol;
export interface DecoratorContextBase {
    webApp: Application | undefined;
    webContext: Context | undefined;
    traceService: TraceService | undefined;
    traceScope: TraceScopeType | undefined;
    /** Caller Class name */
    instanceName: string;
    methodName: string;
}
export interface DecoratorContext<T = ClzInstance> extends DecoratorContextBase {
    traceContext: TraceContext | undefined;
    traceSpan: Span | undefined;
    instance: T;
}