#ifndef CLIENT_H
#define CLIENT_H

#include "ssh_server.h"  /* for client_t */

/* Send `len` bytes to the client over its SSH channel.  Serialised on
 * client->io_lock so concurrent senders don't interleave.  Returns 0 on
 * success, -1 if the channel is gone or a partial write fails. */
int client_send(client_t *client, const char *data, size_t len);

/* Queue an audible bell for the client's own session loop to send.  This
 * avoids writing to another client's SSH channel from the sender's thread. */
void client_queue_bell(client_t *client);

/* Send one queued bell, if present, from the client's own session loop.
 * Returns 0 when no bell was pending or it was written successfully. */
int client_flush_pending_bells(client_t *client);

/* printf-style wrapper around client_send().  The formatted string must
 * fit in 2048 bytes; truncation or encoding errors return -1. */
int client_printf(client_t *client, const char *fmt, ...);

/* Reference counting for safe cross-thread cleanup.
 *
 * Lifecycle: bootstrap_run() creates the client_t with ref_count = 1
 * (the "main" ref), then adds a second ref before installing the channel
 * callbacks (the "callback" ref) so the client outlives any in-flight
 * eof / close / window-change callback invocation.  The interactive
 * session releases both refs in its cleanup path; the final release
 * frees the SSH session, channel, callback struct, and the client_t. */
void client_addref(client_t *client);
void client_release(client_t *client);

/* Install the post-bootstrap channel callbacks (window-change, eof, close)
 * that target this client_t.  Caller MUST have already added one
 * client_addref() to keep the client alive across in-flight callback
 * invocations; the matching client_release() happens during cleanup in
 * input_run_session().  Returns 0 on success, -1 on failure (in which
 * case the caller still owns both refs and must release them). */
int client_install_channel_callbacks(client_t *client);

#endif /* CLIENT_H */