---
name: smtp_send
kind: function
lang: go
domain: infra
version: "1.0.0"
purity: impure
signature: "func SMTPSend(client *smtp.Client, msg EmailMessage) error"
description: "Serializa un EmailMessage a MIME y lo envia usando el smtp.Client dado. Soporta texto plano, HTML, multipart/alternative y adjuntos (multipart/mixed)."
tags: [email, smtp, send, mime, multipart]
uses_functions: [smtp_connect_go_infra]
uses_types: [EmailMessage_go_infra]
returns: []
returns_optional: false
error_type: "error_go_core"
imports: ["bytes", "encoding/base64", "fmt", "mime", "mime/multipart", "net/smtp", "net/textproto", "strings", "time"]
params:
  - name: client
    desc: "cliente SMTP autenticado obtenido de SMTPConnect"
  - name: msg
    desc: "mensaje email con From, To, Subject y al menos un body (HTML o text)"
output: "nil si el envio fue exitoso; error con contexto si falla MAIL FROM, RCPT TO, DATA o la escritura MIME"
tested: true
tests:
  - "envia mensaje texto plano via mock smtp"
  - "envia mensaje html via mock smtp"
  - "envia con adjunto via mock smtp"
test_file_path: "functions/infra/smtp_send_test.go"
file_path: "functions/infra/smtp_send.go"
---

## Ejemplo

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

msg := EmailBuildHTML("u@gmail.com", []string{"dest@example.com"}, "Asunto", "<b>Hola</b>")
if err := SMTPSend(client, msg); err != nil { log.Fatal(err) }
```

## Notas

Funcion impura — envia datos por red. El cliente debe estar autenticado (obtenido de `SMTPConnect`). BCC se incluye en RCPT TO pero no en las cabeceras MIME visibles. Los adjuntos se codifican en base64. Para HTML+texto usa `multipart/alternative`; con adjuntos usa `multipart/mixed`.
