/**
 * @copyright Sister Software
 * @license AGPL-3.0
 * @author Teffen Ellis, et al.
 * @file The injectable time source every timing-sensitive part of {@linkcode APIClient} reads through.
 *
 *   Lifted from `filer/sdk/sec-client.ts` when the SEC client's bespoke pacing/retry
 *   machinery moved down into `@mailwoman/core/api`. Keeping the seam is the whole reason the pacing
 *   and backoff suites are deterministic and finish in milliseconds instead of sleeping on the wall
 *   clock — a rate-limit test that actually waits 100ms per grant costs 4s for a 40-call fan-out and
 *   is flaky under CI load; the same test against an injected clock is exact and instant.
 *
 *   Deliberately NOT `node:timers/promises`: `core/api` reaches a browser bundle (`docs`'s
 *   `DashboardMap` imports `@mailwoman/cartographer`, which barrels `tiles/api.ts`, which imports
 *   `@mailwoman/core/api`), and webpack 5 refuses to resolve a `node:`-prefixed specifier for the
 *   web target. The global `setTimeout` is available on every runtime this package ships to.
 */
/**
 * A minimal, injectable time source. Anything in this package that would otherwise call `Date.now()` or `setTimeout`
 * directly reads through this instead, so tests can drive time deterministically.
 */
export interface ClockLike {
    /**
     * The current time, in milliseconds. Same contract as `Date.now()`.
     */
    now(): number;
    /**
     * Resolve after at least `ms` milliseconds of this clock's time.
     */
    sleep(ms: number): Promise<void>;
}
/**
 * The real-time {@linkcode ClockLike}, used whenever a caller doesn't inject one.
 */
export declare const systemClock: ClockLike;
//# sourceMappingURL=clock.d.ts.map