/**
 * OpenTelemetry semantic-convention helpers for span attributes.
 *
 * Aligns repository / queue / cache adapters with stable OTel semconv keys so
 * downstream collectors and dashboards work without per-adapter mappings.
 *
 * - Database: https://opentelemetry.io/docs/specs/semconv/database/
 * - Messaging: https://opentelemetry.io/docs/specs/semconv/messaging/
 * - Cosmos DB:  https://opentelemetry.io/docs/specs/semconv/database/cosmosdb/
 */
import * as Effect from "effect-app/Effect";
export type DbSystem = "postgresql" | "sqlite" | "cosmosdb" | "mongodb" | "redis" | "other_sql" | "memory" | "disk";
export interface DbSpanOptions {
    /** OTel `db.operation.name` (e.g. `find`, `all`, `filter`, `set`). */
    readonly operation: string;
    readonly system: DbSystem;
    /** Logical collection / table / container name. */
    readonly collection: string;
    /** Tenant / namespace / database name. */
    readonly namespace?: string | undefined;
    /** Application-level entity / model name (custom: `app.entity`). */
    readonly entity?: string | undefined;
    /** Sanitized / parameterized query text. Never include bound values. */
    readonly query?: string | undefined;
    /** Optional fragments merged into final attributes (e.g. id, partition). */
    readonly extra?: Record<string, unknown> | undefined;
}
/**
 * Wrap an effect with an OTel-semconv database span.
 *
 * Span name follows the low-cardinality convention: `<operation> <collection>`.
 */
export declare const withDbSpan: (a: DbSpanOptions) => <A, E, R>(self: Effect.Effect<A, E, R>, ...args: readonly any[]) => Effect.Effect<A, E, Exclude<R, import("effect/Tracer").ParentSpan>>;
/**
 * Annotate the current span with OTel-semconv database attributes.
 *
 * Use when the caller already owns the span (e.g. a repository) and the
 * adapter should only contribute db.* semconv attrs without opening a child.
 * Annotates before running so attrs persist even on failure.
 * No-op if there is no current span.
 */
export declare const annotateDb: (a: DbSpanOptions) => <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
/** Annotate the current span with response metrics from a DB call. */
export declare const annotateDbResponse: (m: {
    readonly returnedRows?: number | undefined;
    readonly responseBytes?: number | undefined;
}) => Effect.Effect<void, never, never>;
/** Cosmos-specific response annotations. */
export declare const annotateCosmosResponse: (m: {
    readonly requestCharge?: number | undefined;
    readonly returnedRows?: number | undefined;
    readonly responseBytes?: number | undefined;
    readonly statusCode?: number | undefined;
}) => Effect.Effect<void, never, never>;
export type MessagingSystem = "servicebus" | "rabbitmq" | "kafka" | "memory" | "sql";
export type MessagingOperation = "publish" | "create" | "receive" | "process" | "settle";
export interface MessagingSpanOptions {
    readonly operation: MessagingOperation;
    readonly system: MessagingSystem;
    /** Queue / topic name. */
    readonly destination: string;
    readonly messageId?: string | undefined;
    readonly conversationId?: string | undefined;
    readonly bodySize?: number | undefined;
    readonly extra?: Record<string, unknown> | undefined;
}
/** Wrap an effect with an OTel-semconv messaging span. */
export declare const withMessagingSpan: (a: MessagingSpanOptions, kind: "producer" | "consumer") => <A, E, R>(self: Effect.Effect<A, E, R>, ...args: readonly any[]) => Effect.Effect<A, E, Exclude<R, import("effect/Tracer").ParentSpan>>;
/** Build messaging span options without wrapping (for Effect.fn / setupRequestContextWithCustomSpan). */
export declare const messagingSpanArgs: (a: MessagingSpanOptions, kind: "producer" | "consumer") => {
    readonly name: `create ${string}` | `process ${string}` | `publish ${string}` | `receive ${string}` | `settle ${string}`;
    readonly kind: "consumer" | "producer";
    readonly attributes: Record<string, unknown>;
};
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib3RlbC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL290ZWwudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7OztHQVNHO0FBRUgsT0FBTyxLQUFLLE1BQU0sTUFBTSxtQkFBbUIsQ0FBQTtBQUUzQyxNQUFNLE1BQU0sUUFBUSxHQUNoQixZQUFZLEdBQ1osUUFBUSxHQUNSLFVBQVUsR0FDVixTQUFTLEdBQ1QsT0FBTyxHQUNQLFdBQVcsR0FDWCxRQUFRLEdBQ1IsTUFBTSxDQUFBO0FBRVYsTUFBTSxXQUFXLGFBQWE7SUFDNUIsc0VBQXNFO0lBQ3RFLFFBQVEsQ0FBQyxTQUFTLEVBQUUsTUFBTSxDQUFBO0lBQzFCLFFBQVEsQ0FBQyxNQUFNLEVBQUUsUUFBUSxDQUFBO0lBQ3pCLG1EQUFtRDtJQUNuRCxRQUFRLENBQUMsVUFBVSxFQUFFLE1BQU0sQ0FBQTtJQUMzQiwwQ0FBMEM7SUFDMUMsUUFBUSxDQUFDLFNBQVMsQ0FBQyxFQUFFLE1BQU0sR0FBRyxTQUFTLENBQUE7SUFDdkMsb0VBQW9FO0lBQ3BFLFFBQVEsQ0FBQyxNQUFNLENBQUMsRUFBRSxNQUFNLEdBQUcsU0FBUyxDQUFBO0lBQ3BDLHdFQUF3RTtJQUN4RSxRQUFRLENBQUMsS0FBSyxDQUFDLEVBQUUsTUFBTSxHQUFHLFNBQVMsQ0FBQTtJQUNuQyw0RUFBNEU7SUFDNUUsUUFBUSxDQUFDLEtBQUssQ0FBQyxFQUFFLE1BQU0sQ0FBQyxNQUFNLEVBQUUsT0FBTyxDQUFDLEdBQUcsU0FBUyxDQUFBO0NBQ3JEO0FBWUQ7Ozs7R0FJRztBQUNILGVBQU8sTUFBTSxVQUFVLE1BQU8sYUFBYSw0SUFLeEMsQ0FBQTtBQUVIOzs7Ozs7O0dBT0c7QUFDSCxlQUFPLE1BQU0sVUFBVSxNQUFPLGFBQWEsTUFBTSxDQUFDLEVBQUUsQ0FBQyxFQUFFLENBQUMsUUFBUSxNQUFNLENBQUMsTUFBTSxDQUFDLENBQUMsRUFBRSxDQUFDLEVBQUUsQ0FBQyxDQUFDLEtBQUcsTUFBTSxDQUFDLE1BQU0sQ0FBQyxDQUFDLEVBQUUsQ0FBQyxFQUFFLENBQUMsQ0FDckMsQ0FBQTtBQUV6RSxzRUFBc0U7QUFDdEUsZUFBTyxNQUFNLGtCQUFrQixNQUFPO0lBQ3BDLFFBQVEsQ0FBQyxZQUFZLENBQUMsRUFBRSxNQUFNLEdBQUcsU0FBUyxDQUFBO0lBQzFDLFFBQVEsQ0FBQyxhQUFhLENBQUMsRUFBRSxNQUFNLEdBQUcsU0FBUyxDQUFBO0NBQzVDLHNDQUlHLENBQUE7QUFFSiw0Q0FBNEM7QUFDNUMsZUFBTyxNQUFNLHNCQUFzQixNQUFPO0lBQ3hDLFFBQVEsQ0FBQyxhQUFhLENBQUMsRUFBRSxNQUFNLEdBQUcsU0FBUyxDQUFBO0lBQzNDLFFBQVEsQ0FBQyxZQUFZLENBQUMsRUFBRSxNQUFNLEdBQUcsU0FBUyxDQUFBO0lBQzFDLFFBQVEsQ0FBQyxhQUFhLENBQUMsRUFBRSxNQUFNLEdBQUcsU0FBUyxDQUFBO0lBQzNDLFFBQVEsQ0FBQyxVQUFVLENBQUMsRUFBRSxNQUFNLEdBQUcsU0FBUyxDQUFBO0NBQ3pDLHNDQU1HLENBQUE7QUFFSixNQUFNLE1BQU0sZUFBZSxHQUN2QixZQUFZLEdBQ1osVUFBVSxHQUNWLE9BQU8sR0FDUCxRQUFRLEdBQ1IsS0FBSyxDQUFBO0FBRVQsTUFBTSxNQUFNLGtCQUFrQixHQUMxQixTQUFTLEdBQ1QsUUFBUSxHQUNSLFNBQVMsR0FDVCxTQUFTLEdBQ1QsUUFBUSxDQUFBO0FBRVosTUFBTSxXQUFXLG9CQUFvQjtJQUNuQyxRQUFRLENBQUMsU0FBUyxFQUFFLGtCQUFrQixDQUFBO0lBQ3RDLFFBQVEsQ0FBQyxNQUFNLEVBQUUsZUFBZSxDQUFBO0lBQ2hDLDBCQUEwQjtJQUMxQixRQUFRLENBQUMsV0FBVyxFQUFFLE1BQU0sQ0FBQTtJQUM1QixRQUFRLENBQUMsU0FBUyxDQUFDLEVBQUUsTUFBTSxHQUFHLFNBQVMsQ0FBQTtJQUN2QyxRQUFRLENBQUMsY0FBYyxDQUFDLEVBQUUsTUFBTSxHQUFHLFNBQVMsQ0FBQTtJQUM1QyxRQUFRLENBQUMsUUFBUSxDQUFDLEVBQUUsTUFBTSxHQUFHLFNBQVMsQ0FBQTtJQUN0QyxRQUFRLENBQUMsS0FBSyxDQUFDLEVBQUUsTUFBTSxDQUFDLE1BQU0sRUFBRSxPQUFPLENBQUMsR0FBRyxTQUFTLENBQUE7Q0FDckQ7QUFZRCwwREFBMEQ7QUFDMUQsZUFBTyxNQUFNLGlCQUFpQixNQUN6QixvQkFBb0IsUUFDakIsVUFBVSxHQUFHLFVBQVUsNElBTTVCLENBQUE7QUFFSCx5R0FBeUc7QUFDekcsZUFBTyxNQUFNLGlCQUFpQixNQUN6QixvQkFBb0IsUUFDakIsVUFBVSxHQUFHLFVBQVU7Ozs7Q0FNbEIsQ0FBQSJ9