(** Low-level buffer writing primitives for HTTP response generation. *)

(** {1 Basic Writers} *)

(** Write a single character. Returns [off + 1]. *)
val char : Base_bigstring.t -> off:int -> char -> int

(** Write a string. Returns [off + String.length s]. *)
val string : Base_bigstring.t -> off:int -> string -> int

(** Write CRLF ([\r\n]). Returns [off + 2]. *)
val crlf : Base_bigstring.t -> off:int -> int

(** {1 Integer Writers} *)

(** Write a non-negative integer in decimal. Returns new offset. *)
val int : Base_bigstring.t -> off:int -> int -> int

(** Write an int64 in decimal. Returns new offset. *)
val int64 : Base_bigstring.t -> off:int -> int64 -> int

(** Write a non-negative integer in lowercase hexadecimal. Returns new offset. *)
val hex : Base_bigstring.t -> off:int -> int -> int

(** {1 Fixed-Width Writers} *)

(** Write a 2-digit decimal number (zero-padded). Returns [off + 2]. *)
val digit2 : Base_bigstring.t -> off:int -> int -> int

(** Write a 4-digit decimal number (zero-padded). Returns [off + 4]. *)
val digit4 : Base_bigstring.t -> off:int -> int -> int