bufread.h

#ifndef BUFREAD_H
#define BUFREAD_H

#include <stddef.h>
#include <sys/types.h>
#include <stdbool.h>

#define BUFFER_CAPACITY 4096

typedef struct
{
  char buffer[BUFFER_CAPACITY];
  size_t pos;
  size_t length;
  int socket;
  bool eof;
  int error;
} bufreader_t;
/**
 * Initialize a buffered reader for the given socket.
 */
bufreader_t *br_init(int socket);

/**
 * Read a line from the buffer reader into a newly allocated buffer.
 * The returned line is null-terminated and includes the newline character.
 * Returns the length of the line (including the '\n'), or -1 on error.
 * The caller is responsible for freeing `*dest`.
 */
ssize_t br_readline(bufreader_t *r, char **dest);

/**
 * Free the buffer reader and its resources.
 */
void br_free(bufreader_t *r);

#endif // BUFREAD_H