Skip to content

Ministack: Free, open-source local AWS emulator - 60+ services, Terraform compatible, real databases. Free forever. MIT licensed.

fix(ses): route POST /v2/email/outbound-bulk-emails (SendBulkEmail) (#1670)

Johannes Grumböck06d95199b34a
diff --git a/ministack/services/ses_v2.py b/ministack/services/ses_v2.py
index 9f1a5d7c..2b0abb8d 100644
--- a/ministack/services/ses_v2.py
+++ b/ministack/services/ses_v2.py
@@ -385,6 +385,68 @@ async def handle_request(method, path, headers, body, query_params):
f" | template={template_name}" if template_name else "")
return json_response({"MessageId": msg_id})
+ # POST /v2/email/outbound-bulk-emails (SendBulkEmail)
+ if sub == "/outbound-bulk-emails" and method == "POST":
+ source = data.get("FromEmailAddress", "")
+ config_set = data.get("ConfigurationSetName", "")
+ tpl = data.get("DefaultContent", {}).get("Template", {})
+ if not tpl:
+ return _json_err("BadRequestException", "DefaultContent.Template is required")
+ stored, template_name, err = _resolve_send_template(tpl)
+ if err:
+ return err
+ default_data = tpl.get("TemplateData", "")
+ entries = data.get("BulkEmailEntries", [])
+ if not entries:
+ return _json_err("BadRequestException", "BulkEmailEntries is required")
+
+ results = []
+ for entry in entries:
+ dest = entry.get("Destination", {})
+ to_addrs = dest.get("ToAddresses", [])
+ cc_addrs = dest.get("CcAddresses", [])
+ bcc_addrs = dest.get("BccAddresses", [])
+ template_data = (
+ entry.get("ReplacementEmailContent", {})
+ .get("ReplacementTemplate", {})
+ .get("ReplacementTemplateData", default_data)
+ )
+ rendered = _render_template(stored, template_data)
+ subj = rendered.get("Subject", "")
+ body_text = rendered.get("Text", "")
+ body_html = rendered.get("Html", "")
+ msg_id = f"ministack-{new_uuid()}"
+
+ all_addrs = to_addrs + cc_addrs + bcc_addrs
+ if source and all_addrs:
+ mime_str = _build_mime_message(source, to_addrs, cc_addrs, bcc_addrs,
+ subj, body_text, body_html, msg_id)
+ _smtp_relay(source, all_addrs, mime_str)
+
+ record = {
+ "MessageId": msg_id,
+ "Source": source,
+ "To": to_addrs,
+ "CC": cc_addrs,
+ "BCC": bcc_addrs,
+ "Subject": subj,
+ "BodyText": body_text,
+ "BodyHtml": body_html,
+ "TemplateData": template_data,
+ "Timestamp": time.time(),
+ "Type": "v2.SendBulkEmail",
+ }
+ if template_name:
+ record["Template"] = template_name
+ if config_set:
+ record["ConfigurationSetName"] = config_set
+ _sent_emails_list().append(record)
+ results.append({"Status": "SUCCESS", "MessageId": msg_id})
+
+ logger.info("SESv2 SendBulkEmail: %s | template=%s | %s entries",
+ source, template_name or "<inline>", len(entries))
+ return json_response({"BulkEmailEntryResults": results})
+
# POST /v2/email/identities (CreateEmailIdentity)
if sub == "/identities" and method == "POST":
identity = data.get("EmailIdentity", "")
diff --git a/tests/test_ses_v2.py b/tests/test_ses_v2.py
index 944b22bb..d9214ce0 100644
--- a/tests/test_ses_v2.py
+++ b/tests/test_ses_v2.py
@@ -454,3 +454,136 @@ def test_ses_v2_send_email_rejects_unusable_templates_without_recording_sends(
assert status == expected_status
assert body["name"] == expected_error
assert ses_v2._sent_emails_list() == []
+
+
+async def _post_via_app(path, body):
+ """Drive MiniStack's ASGI ``app`` in-process so the /v2/email router is exercised."""
+ from ministack.app import app as asgi_app
+
+ raw = json.dumps(body).encode("utf-8")
+ messages = []
+
+ async def send(message):
+ messages.append(message)
+
+ sent = False
+
+ async def receive():
+ nonlocal sent
+ if not sent:
+ sent = True
+ return {"type": "http.request", "body": raw, "more_body": False}
+ return {"type": "http.request", "body": b"", "more_body": False}
+
+ scope = {
+ "type": "http",
+ "asgi": {"version": "3.0", "spec_version": "2.3"},
+ "http_version": "1.1",
+ "method": "POST",
+ "scheme": "http",
+ "path": path,
+ "raw_path": path.encode("utf-8"),
+ "root_path": "",
+ "query_string": b"",
+ "headers": [
+ (b"host", b"localhost:4566"),
+ (b"content-type", b"application/json"),
+ (b"content-length", str(len(raw)).encode("ascii")),
+ ],
+ "client": ("127.0.0.1", 55555),
+ "server": ("127.0.0.1", 4566),
+ }
+ await asgi_app(scope, receive, send)
+ start = next(m for m in messages if m["type"] == "http.response.start")
+ payload = b"".join(m.get("body", b"") for m in messages if m["type"] == "http.response.body")
+ return start["status"], json.loads(payload.decode("utf-8")) if payload else {}
+
+
+def _bulk_body(template, entries):
+ return {
+ "FromEmailAddress": "[email protected]",
+ "DefaultContent": {"Template": dict(template, TemplateData=json.dumps({"name": "Default"}))},
+ "BulkEmailEntries": entries,
+ }
+
+
+def _bulk_entry(to, **replacement):
+ entry = {"Destination": {"ToAddresses": [to]}}
+ if replacement:
+ entry["ReplacementEmailContent"] = {
+ "ReplacementTemplate": {"ReplacementTemplateData": json.dumps(replacement)}
+ }
+ return entry
+
+
+def test_ses_v2_send_bulk_email_via_app_router_with_inline_template(ses_v2):
+ status, body = asyncio.run(
+ _post_via_app(
+ "/v2/email/outbound-bulk-emails",
+ _bulk_body(
+ {"TemplateContent": {"Subject": "Hi {{name}}", "Text": "Body {{name}}"}},
+ [_bulk_entry("[email protected]", name="Alice"), _bulk_entry("[email protected]")],
+ ),
+ )
+ )
+
+ assert status == 200
+ results = body["BulkEmailEntryResults"]
+ assert len(results) == 2
+ assert all(r["Status"] == "SUCCESS" and r["MessageId"] for r in results)
+ assert len({r["MessageId"] for r in results}) == 2
+
+ records = ses_v2._sent_emails_list()
+ assert [r["Type"] for r in records] == ["v2.SendBulkEmail"] * 2
+ assert [r["MessageId"] for r in records] == [r["MessageId"] for r in results]
+ assert records[0]["To"] == ["[email protected]"]
+ assert records[0]["Subject"] == "Hi Alice"
+ assert records[1]["Subject"] == "Hi Default"
+ assert records[1]["BodyText"] == "Body Default"
+ assert "Template" not in records[0]
+ assert list(ses_v2._templates.values()) == []
+
+
+def test_ses_v2_send_bulk_email_via_app_router_with_stored_template(ses_v2):
+ _call(
+ ses_v2,
+ "POST",
+ "/v2/email/templates",
+ body={"TemplateName": "bulk-tpl", "TemplateContent": {"Subject": "S {{name}}", "Text": "T {{name}}"}},
+ )
+
+ status, body = asyncio.run(
+ _post_via_app(
+ "/v2/email/outbound-bulk-emails",
+ _bulk_body(
+ {"TemplateName": "bulk-tpl"},
+ [
+ _bulk_entry("[email protected]", name="A"),
+ _bulk_entry("[email protected]", name="B"),
+ _bulk_entry("[email protected]"),
+ ],
+ ),
+ )
+ )
+
+ assert status == 200
+ results = body["BulkEmailEntryResults"]
+ assert len(results) == 3
+ assert all(r["Status"] == "SUCCESS" for r in results)
+
+ records = ses_v2._sent_emails_list()
+ assert [r["Subject"] for r in records] == ["S A", "S B", "S Default"]
+ assert all(r["Template"] == "bulk-tpl" for r in records)
+
+
+def test_ses_v2_send_bulk_email_rejects_missing_template_without_recording_sends(ses_v2):
+ status, body = asyncio.run(
+ _post_via_app(
+ "/v2/email/outbound-bulk-emails",
+ _bulk_body({"TemplateName": "missing"}, [_bulk_entry("[email protected]")]),
+ )
+ )
+
+ assert status == 404
+ assert body["name"] == "NotFoundException"
+ assert ses_v2._sent_emails_list() == []