/**
 * @pwngh/economy-lab
 *
 * Copyright (c) Preston Neal
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE.md file in the root directory of this source tree.
 *
 * @license MIT
 */
import type { Dispatcher } from '../../src/ports.js';
/**
 * Wraps one Dispatcher adapter over a controllable fake transport. It records the message bodies
 * sent and the abort signals seen. Calling `failNext` makes the next dispatch throw a transport
 * error. The shared suite uses this to exercise the success, failure, and cancellation paths
 * uniformly across adapters.
 *
 * The contract a host's harness must uphold: `bodies` grows by the exact string the adapter handed
 * the transport, one entry per dispatch; `signals` records the per-dispatch abort signal, with
 * `undefined` recorded when the caller passed none; `failNext(error)` arms only the next dispatch,
 * which must surface the failure as the transport error would.
 */
export interface DispatcherHarness {
    dispatcher: Dispatcher;
    bodies: ReadonlyArray<string>;
    signals: ReadonlyArray<AbortSignal | undefined>;
    failNext(error: Error): void;
}
/**
 * Runs the shared {@link Dispatcher} contract that every adapter must satisfy. It runs against the
 * HTTP and SQS adapters over fake transports, following the same pattern as
 * `test/conformance/store.ts`.
 *
 * The encoding test pins both transports to one byte-for-byte body from `encodeEvent`, so HTTP and
 * SQS cannot silently diverge in what a receiver sees. The failure test pins the error contract the
 * relay worker depends on: a retryable `PROVIDER.FAILURE` so a failed delivery redelivers. The
 * signal test pins cancellation forwarding.
 *
 * A host wires its own adapter in by building a {@link DispatcherHarness} over a fake of its
 * transport and calling this at the top level of a `node --test` file. The factory runs afresh
 * inside each test, so each test sees an empty recording.
 */
export declare function runDispatcherConformance(name: string, makeHarness: () => DispatcherHarness): void;