import type { AwsClientLike } from "./cloudformationEventTypes.js";
import { type OperationStart, type StackLevelEvent, type TimedStackEvent } from "./stackOperationOutcome.js";
export type StackEventsSinceRead = {
    readonly kind: "read";
    readonly events: readonly TimedStackEvent[];
} | {
    readonly kind: "absent";
} | {
    readonly kind: "unreadable";
    readonly reason: string;
};
/**
 * Every event the stack logged at or after `since`, oldest first, paged from
 * DescribeStackEvents' newest-first answer until the first event older than
 * `since` or the last page. More than `maxPages` pages without reaching
 * `since`, an answer with no event list, an event with no time, a failed
 * read and the caller's cancel are each `unreadable`: none of them proves
 * which events the stack logged. Absent only on CloudFormation's own
 * not-found answer.
 */
export declare function readStackEventsSince(aws: AwsClientLike, stackName: string, since: Date, abortSignal?: AbortSignal, { maxPages }?: {
    readonly maxPages?: number;
}): Promise<StackEventsSinceRead>;
export type UpdateEventsRead = {
    readonly kind: "read";
    /** The update's start, its stack-level UPDATE_IN_PROGRESS. */
    readonly start: OperationStart;
    /** Every event from the start on, oldest first. */
    readonly events: readonly TimedStackEvent[];
} | {
    readonly kind: "start-not-found";
} | {
    readonly kind: "absent";
} | {
    readonly kind: "unreadable";
    readonly reason: string;
};
/**
 * The events of the update that logged an event at `anchor.timestamp`, from
 * its start on, oldest first: paged from DescribeStackEvents' newest-first
 * answer back to the newest stack-level UPDATE_IN_PROGRESS at or before the
 * anchor, which is that update's start, since CloudFormation runs one
 * operation on a stack at a time. A later operation's start is passed over,
 * not taken for it. When the anchor carries the update's request token, the
 * start must carry it too. A start carrying another, or pages that run out
 * first, is `start-not-found`. More than `maxPages` pages, an answer with no
 * event list, an event with no time, a failed read and the caller's cancel
 * are each `unreadable`. Absent only on CloudFormation's own not-found
 * answer.
 */
export declare function readUpdateEventsFrom(aws: AwsClientLike, stackName: string, anchor: OperationStart, abortSignal?: AbortSignal, { maxPages }?: {
    readonly maxPages?: number;
}): Promise<UpdateEventsRead>;
export type NewestStackLevelEventRead = {
    readonly kind: "read";
    readonly event: StackLevelEvent;
} | {
    readonly kind: "absent";
} | {
    readonly kind: "unreadable";
    readonly reason: string;
};
/**
 * The newest event of the stack itself on the first page of its events,
 * read with `fetchNewestStackEvents`, or why it could not be read: the read
 * failed, the page holds no event of the stack itself, or the newest one
 * carries no time to compare.
 */
export declare function newestStackLevelEvent(aws: AwsClientLike, stackName: string, abortSignal?: AbortSignal): Promise<NewestStackLevelEventRead>;