import type { PeerMessage } from './types.js';
import type { PubKeyHex } from '../wallet/Wallet.interfaces.js';
/**
 * Abstract communications layer.
 *
 * This intentionally mirrors the essential subset of message-box-client / MessageBoxClient.
 * RemittanceManager never talks directly to HTTP/WebSockets – it only uses this interface.
 */
export interface CommsLayer {
    /**
     * Sends a message over the store-and-forward channel. Returns the transport messageId.
     */
    sendMessage: (args: {
        recipient: PubKeyHex;
        messageBox: string;
        body: string;
    }, hostOverride?: string) => Promise<string>;
    /**
     * Sends a message over the live channel (e.g. WebSocket). Returns the transport messageId.
     * Implementers may throw if live sending is not possible.
     * RemittanceManager will fall back to sendMessage where appropriate.
     */
    sendLiveMessage?: (args: {
        recipient: PubKeyHex;
        messageBox: string;
        body: string;
    }, hostOverride?: string) => Promise<string>;
    /**
     * Lists pending messages for a message box.
     */
    listMessages: (args: {
        messageBox: string;
        host?: string;
    }) => Promise<PeerMessage[]>;
    /**
     * Acknowledges messages (deletes them from the server / inbox).
     */
    acknowledgeMessage: (args: {
        messageIds: string[];
    }) => Promise<void>;
    /**
     * Optional live listener.
     */
    listenForLiveMessages?: (args: {
        messageBox: string;
        overrideHost?: string;
        onMessage: (msg: PeerMessage) => void;
    }) => Promise<void>;
}
//# sourceMappingURL=CommsLayer.d.ts.map