import { APIResource } from "../core/resource.js";
import { APIPromise } from "../core/api-promise.js";
import { CursorPagination, type CursorPaginationParams, PagePromise } from "../core/pagination.js";
import { RequestOptions } from "../internal/request-options.js";
export declare class Events extends APIResource {
    /**
     * Retrieves an event by ID.
     */
    retrieve(id: string, options?: RequestOptions): APIPromise<Event>;
    /**
     * Retrieve a paginated list of events.
     */
    list(query?: EventListParams | null | undefined, options?: RequestOptions): PagePromise<EventsCursorPagination, Event>;
    /**
     * Verifies the webhook signature and parses the payload into an Event.
     *
     * @param body - The raw request body as a string or ArrayBuffer. Must be the exact bytes received; do not modify.
     * @param signatureHeader - The value of the `x-rye-signature` HTTP header.
     * @param secret - Your webhook secret key (typically from the `RYE_HMAC_SECRET_KEY` environment variable).
     * @returns The parsed Event if the signature is valid.
     * @throws WebhookSignatureVerificationError if the signature is missing, malformed, or invalid.
     */
    unwrap(body: string | ArrayBuffer, signatureHeader: string | null, secret: string): Promise<Event>;
}
export type EventsCursorPagination = CursorPagination<Event>;
export interface Event {
    /**
     * Unique identifier for the event. This can be used as an idempotency key to avoid
     * double-processing of the same underlying event.
     */
    id: string;
    /**
     * Timestamp of when the event was created.
     */
    createdAt: string;
    object: 'event';
    /**
     * A reference to the object which triggered the event.
     *
     * You should use the API to fetch the full object details.
     */
    source: Event.Source;
    /**
     * Description of the event.
     *
     * Refer to [types of events](https://docs.rye.com/api-v2/webhooks/types) for a
     * list of possible values.
     */
    type: 'checkout_intent.offer_retrieved' | 'checkout_intent.offer_failed' | 'checkout_intent.completed' | 'checkout_intent.order_failed' | 'shipment.created' | 'shipment.updated' | 'product.updated' | 'product.removed' | 'webhook_endpoint.verification_challenge';
    /**
     * The event data payload. The concrete shape depends on `source.type`.
     *
     * Refer to [webhook event types](https://docs.rye.com/api-v2/webhooks/types) for
     * the payload shape associated with each `source.type`.
     */
    data?: {
        [key: string]: unknown;
    };
}
export declare namespace Event {
    /**
     * A reference to the object which triggered the event.
     *
     * You should use the API to fetch the full object details.
     */
    interface Source {
        /**
         * ID of the object which triggered the event.
         */
        id: string;
        /**
         * Type of the object which triggered the event.
         */
        type: 'checkout_intent' | 'shipment' | 'product' | 'webhook_endpoint';
    }
}
export interface EventListParams extends CursorPaginationParams {
}
export declare namespace Events {
    export { type Event as Event, type EventsCursorPagination as EventsCursorPagination, type EventListParams as EventListParams, };
}
//# sourceMappingURL=events.d.ts.map