lumenmail/network

Network module for SMTP operations. Provides TCP and SSL socket handling using Erlang’s gen_tcp and ssl modules. This is a pure Gleam implementation using @external declarations.

Types

Socket

</>

Opaque socket type that can be either TCP or SSL socket.

pub type Socket

TcpOption

</>

Options for TCP connection.

pub type TcpOption {
  Binary
  ActiveFalse
  PacketLine
  ReuseAddr
}

Constructors

```
Binary
```
```
ActiveFalse
```
```
PacketLine
```
```
ReuseAddr
```

Values

close_socket

</>

pub fn close_socket(socket: Socket, is_tls: Bool) -> Nil

Closes the socket.

read_multiline_response

</>

pub fn read_multiline_response(
  socket: Socket,
  is_tls: Bool,
  timeout: Int,
) -> Result(types.SmtpResponse, types.SmtpError)

Reads a multi-line SMTP response (e.g., EHLO response).

read_response

</>

pub fn read_response(
  socket: Socket,
  is_tls: Bool,
  timeout: Int,
) -> Result(types.SmtpResponse, types.SmtpError)

Reads a single-line SMTP response.

send_command

</>

pub fn send_command(
  socket: Socket,
  is_tls: Bool,
  command: String,
  timeout: Int,
) -> Result(Nil, types.SmtpError)

Sends an SMTP command (appends CRLF).

send_data

</>

pub fn send_data(
  socket: Socket,
  is_tls: Bool,
  data: String,
  timeout: Int,
) -> Result(Nil, types.SmtpError)

Sends raw data (for message body) with dot-stuffing.

ssl_connect

</>

pub fn ssl_connect(
  socket: Socket,
  host: String,
  allow_invalid_certs: Bool,
  timeout: Int,
) -> Result(Socket, types.SmtpError)

Upgrades a TCP socket to SSL/TLS.

tcp_connect

</>

pub fn tcp_connect(
  host: String,
  port: Int,
  timeout: Int,
) -> Result(Socket, types.SmtpError)

Establishes a TCP connection to the SMTP server.