Function pollUntilTerminal

packages/cli/src/cloud/poll.ts:56–87

(
  client: HyperframesCloudClient,
  renderId: string,
  options: PollOptions = {},
)

 * on a retry inside the poll window.
 */
export async function pollUntilTerminal(
  client: HyperframesCloudClient,
  renderId: string,
  options: PollOptions = {},
): Promise<HyperframesRenderDetail> {
  const intervalMs = options.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;
  const maxWaitMs = options.maxWaitMs ?? DEFAULT_MAX_WAIT_MS;
  const now = options.now ?? (() => Date.now());
  // Default sleep honors the abort signal so Ctrl+C feels immediate
  // instead of waiting out the full interval. Tests inject a no-op
  // sleep that ignores the signal — that's fine, they don't abort.
  const sleep = options.sleep ?? defaultAbortableSleep(options.signal);

  const started = now();

  while (true) {
    if (options.signal?.aborted) {
      throw signalAbortError(options.signal);
    }
    const detail = await client.getRender({ render_id: renderId, signal: options.signal });
    const elapsed = now() - started;
    options.onTick?.(detail, elapsed);

    if (isTerminal(detail.status)) {
      return detail;
    }
    if (elapsed >= maxWaitMs) {
      throw new PollTimeoutError(detail, elapsed);
    }
    await sleep(intervalMs);
  }
}

function signalAbortError(signal: AbortSignal): Error {
  const reason = signal.reason;