import type { AddOn } from '@heroku/types/3.sdk';
import type { ResourceCtx } from '../../../core/extend-resource.js';
import type { WaitForProvisioningOptions } from './types.js';
/**
 * Poll add-on state until it leaves a non-terminal state.
 *
 * When `appIdentity` is provided, polls `GET /apps/:app/addons/:addon`
 * (app-scoped). Without it, polls `GET /addons/:addon` (global).
 *
 * Terminal states: `provisioned`, `deprovisioned`. Polling continues
 * while the add-on is in `provisioning` or `deprovisioning`.
 *
 * Throws `AddonProvisioningFailedError` if the terminal state is
 * `deprovisioned`.
 *
 * The `Accept-Expansion: addon_service,plan` header is included on
 * each poll to match the existing CLI behaviour.
 */
export declare function waitForProvisioning(ctx: Pick<ResourceCtx, 'platform'>, addon: AddOn, options?: WaitForProvisioningOptions): Promise<AddOn>;