---
name: smtp_connect
kind: function
lang: go
domain: infra
version: "1.0.0"
purity: impure
signature: "func SMTPConnect(cfg SMTPConfig) (*smtp.Client, error)"
description: "Establece una conexion SMTP autenticada. TLSMode 'tls' usa TLS directo (port 465), 'starttls' hace upgrade STARTTLS (port 587), '' sin cifrado (port 25). Retorna un *smtp.Client listo para usar con SMTPSend."
tags: [email, smtp, connection, tls, starttls, auth]
uses_functions: []
uses_types: [SMTPConfig_go_infra]
returns: []
returns_optional: false
error_type: "error_go_core"
imports: ["crypto/tls", "fmt", "net", "net/smtp"]
params:
  - name: cfg
    desc: "configuracion SMTP: host, port, usuario, password y modo TLS"
output: "*smtp.Client autenticado y listo para enviar mensajes; el caller debe llamar client.Quit() al terminar"
tested: true
tests:
  - "conecta sin cifrado a servidor mock"
  - "error si el servidor no existe"
test_file_path: "functions/infra/smtp_connect_test.go"
file_path: "functions/infra/smtp_connect.go"
---

## Ejemplo

```go
cfg := SMTPConfig{Host: "smtp.gmail.com", Port: 587, Username: "u@gmail.com", Password: "app-pw", TLSMode: "starttls"}
client, err := SMTPConnect(cfg)
if err != nil {
    log.Fatal(err)
}
defer client.Quit()
// pasar client a SMTPSend(...)
```

## Notas

Funcion impura — abre conexion TCP real. El caller es responsable de cerrar el cliente con `client.Quit()`. Para test unitario usar un listener TCP local como mock. `SMTPSend` acepta el `*smtp.Client` retornado por esta funcion.