import { type JsonCompatibleObject, type PartialWithUndefined, type RequireOneOrNone } from '@augment-vir/common';
import { type Attachment, type ScopeContext, type setTags } from '@sentry/core';
import { type EventSeverityEnum } from './event-severity.js';
export type { Attachment } from '@sentry/core';
/**
 * Used for all extra context types. While keys must be strings, values can be whatever but must be
 * JSON compatible.
 */
export type EventExtraContext = JsonCompatibleObject;
/** Allowed tag value types for Sentry event tags. */
export type EventTags = Parameters<typeof setTags>[0];
/**
 * Combined context, tags, and attachments parameter used for event logging functions. All
 * properties are optional.
 */
export type EventContextAndTags = PartialWithUndefined<{
    context: EventExtraContext;
    tags: EventTags;
    attachments: ReadonlyArray<Attachment>;
    /**
     * Per-event throttle override. At most one of `threshold` / `disabled` may be set: `threshold`
     * tightens throttling for this event, `disabled` bypasses it entirely.
     */
    throttle: ThrottleOverride;
}>;
/**
 * Per-event throttle override carried alongside an event. At most one of `threshold` / `disabled`
 * may be set on a single override.
 *
 * @category Internal
 */
export type ThrottleOverride = RequireOneOrNone<{
    /**
     * Per-event throttle threshold override. When set, throttling for this event uses the minimum
     * of this value and the globally-configured `throttleThreshold`, allowing individual log calls
     * to be throttled more aggressively than the global default.
     */
    threshold: number;
    /**
     * When `true`, this event bypasses the throttle check entirely — it is always forwarded to
     * Sentry and does not count against its cluster's interval bucket. Useful for important events
     * that should never be dropped (e.g. critical alerts).
     */
    disabled: boolean;
}>;
/** Function that generates extra event context. */
export type EventExtraContextCreator = () => EventExtraContext;
/** Event details before getting sent to Sentry. */
export type EventDetails = {
    extraContext?: EventExtraContext | undefined;
    tags?: EventTags | undefined;
    attachments?: ReadonlyArray<Attachment> | undefined;
    severity: EventSeverityEnum;
};
/** Options for creating contexts. Used internally. */
export type ContextOptions = {
    /**
     * If true, this means the message was sent before Sentry was initialized, which slightly
     * changes how the event is logged in the browser.
     */
    wasSentPrematurely: boolean;
};
/**
 * Maps internal EventDetails type to Sentry's required type for event severity, extra context, and
 * tags.
 */
export declare function convertEventDetailsToSentryContext(eventDetails: EventDetails, options: ContextOptions): Pick<ScopeContext, 'extra' | 'level'> & Partial<Pick<ScopeContext, 'tags'>>;