feat(shared): decompose SMTP_CONNECTION_URL into individual env vars

[msukkari]

Summary

Add support for configuring SMTP via individual environment variables (SMTP_HOST, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD) as an alternative to providing the full SMTP_CONNECTION_URL. This mirrors how DATABASE_URL can be decomposed into separate components.

Changes

• Created packages/shared/src/smtp.ts with getSMTPConnectionURL() helper that constructs the connection URL, maintaining backward compatibility
• Updated packages/shared/src/env.server.ts to define the new SMTP environment variables
• Updated entrypoint.sh to support SMTP URL construction at the shell level
• Modified packages/web/src/auth.ts and packages/web/src/actions.ts to use the new helper function
• Updated documentation to show both configuration methods with precedence rules

Fixes SOU-637

Summary by CodeRabbit

• New Features

  • SMTP can now be configured using individual environment variables (SMTP_HOST, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD) as an alternative to SMTP_CONNECTION_URL.

• Documentation

  • Updated configuration documentation to include the new SMTP environment variable options and their usage.

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

Walkthrough

This PR introduces support for configuring SMTP via individual environment variables (SMTP_HOST, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD) as an alternative to SMTP_CONNECTION_URL. A new utility function constructs SMTP connection URLs from individual variables when the monolithic connection string is unavailable. Documentation and email-sending code paths are updated accordingly.

Changes

Cohort / File(s)	Summary
Documentation CHANGELOG.md, docs/docs/configuration/environment-variables.mdx, docs/docs/configuration/transactional-emails.mdx	Added documentation for new SMTP environment variables and clarified that individual SMTP settings can be used to construct the connection URL, with SMTP_CONNECTION_URL taking precedence.
Environment Schema packages/shared/src/env.server.ts	Added four new optional environment variable declarations: SMTP_HOST (string), SMTP_PORT (number), SMTP_USERNAME (string), and SMTP_PASSWORD (string) to the server options schema.
SMTP Utility packages/shared/src/smtp.ts, packages/shared/src/index.server.ts	Introduced new module with getSMTPConnectionURL() function that returns SMTP_CONNECTION_URL if available, otherwise constructs URL from individual variables, returning undefined if required variables are missing or incompletely configured.
Email Integration packages/web/src/actions.ts, packages/web/src/auth.ts	Replaced direct env.SMTP_CONNECTION_URL access with getSMTPConnectionURL() utility across multiple email-sending code paths (invites, account requests, join approvals).
Miscellaneous entrypoint.sh	Corrected comment typo: "Descontruct" → "Construct".

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

Possibly related PRs

• fix(web): Use AUTH_URL when generating external links #844: Centralizes SMTP connection URL sourcing through a new utility function, similar to how that PR centralizes AUTH_URL handling across email-sending code paths.

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main change: adding support for decomposing SMTP_CONNECTION_URL into individual environment variables (SMTP_HOST, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD). It is clear, specific, and concise.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

• 📝 Generate docstrings (stacked PR)
• 📝 Generate docstrings (commit on current branch)

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch msukkari/smtp-env-vars-SOU-637

📝 Coding Plan

• Generate coding plan for human review comments

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}