import type { FaucetDefinition, FaucetHandler } from './types.js';
/**
 * The consumer-side builder. A faucet binds to a valve by name — never to the
 * producer silo — and lands every (re-validated) payload in a consumer entity.
 * `.on()` is terminal: supplying the intake handler registers the faucet.
 */
export interface FaucetBuilder<TPayload> {
    /** The consumer entity the payload lands in. */
    into(target: string): FaucetBuilder<TPayload>;
    /** The intake handler. Terminal — registers the faucet and returns its definition. */
    on(handler: FaucetHandler<TPayload>): FaucetDefinition<TPayload>;
}
/**
 * Declare a faucet — the consumer side of a `supply -> faucet` edge. `valve` is
 * the name of the producer valve this faucet consumes.
 */
export declare function faucet<TPayload = unknown>(valve: string): FaucetBuilder<TPayload>;
//# sourceMappingURL=faucet.d.ts.map