import { Logger } from './types.js';

interface WsHostOverrides {
    hostname?: string;
    port?: string | number;
    path?: string;
    url?: string;
}
interface WsLoggerOptions {
    /**
     * Whether this client REQUIRES the server's ack capability. Default false.
     *
     * false (writing_observer, other ack-less consumers): if ack isn't
     *   advertised, fall back to legacy send-and-delete (graceful degrade).
     * true (lo-blocks): if the server doesn't advertise `ack` (no `hello`,
     *   `hello` without it, or the grace window expires), FAIL LOUDLY — throw +
     *   visible error, and do NOT run legacy. A require-ack client on an
     *   ack-less server is a mis-deploy; running legacy silently loses events,
     *   which is the exact bug this protocol fixes. Fail fast, never run bad code.
     */
    requireAck?: boolean;
}
declare function websocketLogger(server?: string | WsHostOverrides, opts?: WsLoggerOptions): Logger;

export { websocketLogger };