[PM-21918] update send api models to support new email field

[audreyality]

🎟️ Tracking

https://bitwarden.atlassian.net/browse/PM-21918
https://bitwarden.atlassian.net/browse/PM-29783
https://bitwarden.atlassian.net/browse/PM-29789

https://bitwarden.atlassian.net/wiki/spaces/EN/pages/2164654083/Email-authenticated+Sends+-+Updated

Implements #5895

📔 Objective

Original

Update send API models to support email/OTP administration.

Important

This PR includes documentation for the related models. I mostly inferred what each of these are. Please focus on them during review to confirm that the comments are correct.

Updated

In a recent tech breakdown it was decided we would also add an explicit property AuthType that will allow the client to determine the authentication strategy to use (email OTP, password, or none) without relying on the presence or absence of Emails or Password properties in order to infer the strategy. The latest iteration of this PR accomplishes the following:

• authentication strategy inference is still preserved, and is used as a fallback when the nullable AuthType property is not set
• send-related models that were previously updated to include Emails were also updated to include the AuthType property
• most FIXMEs were addressed: One overload of ToSend was renamed to UpdateSend and GlobalSettings were eliminated from one of the updated files
• extensive test coverage was added to cover AuthType inference, explicit assignment, and other behavior not formerly covered in SendsController

⏰ Reminders before review

• Contributor guidelines followed
• All formatters and local linters executed and passed
• Written new unit and / or integration tests where applicable
• Protected functional changes with optionality (feature flags)
• Used internationalization (i18n) for all UI strings
• CI builds passed
• Communicated to DevOps any deployment requirements
• Updated any necessary documentation (Confluence, contributing docs) or informed the documentation team

🦮 Reviewer guidelines

• 👍 (:+1:) or similar for great changes
• 📝 (:memo:) or ℹ️ (:information_source:) for notes or general info
• ❓ (:question:) for questions
• 🤔 (:thinking:) or 💭 (:thought_balloon:) for more open inquiry that's not quite a confirmed issue and could potentially benefit from discussion
• 🎨 (:art:) for suggestions / improvements
• ❌ (:x:) or ⚠️ (:warning:) for more significant problems or concerns needing attention
• 🌱 (:seedling:) or ♻️ (:recycle:) for future improvements or indications of technical debt
• ⛏ (:pick:) for minor or nitpick changes

[codecov]

Codecov Report

❌ Patch coverage is 80.00000% with 19 lines in your changes missing coverage. Please review.
✅ Project coverage is 58.72%. Comparing base (96622d7) to head (6bfacec).
⚠️ Report is 16 commits behind head on main.

Files with missing lines	Patch %	Lines
src/Api/Tools/Controllers/SendsController.cs	51.51%	10 Missing and 6 partials ⚠️
.../Core/Tools/SendFeatures/Queries/SendOwnerQuery.cs	88.88%	0 Missing and 3 partials ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #5895      +/-   ##
==========================================
+ Coverage   58.58%   58.72%   +0.14%     
==========================================
  Files        1920     1922       +2     
  Lines       85264    85328      +64     
  Branches     7632     7649      +17     
==========================================
+ Hits        49953    50112     +159     
+ Misses      33465    33356     -109     
- Partials     1846     1860      +14     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[jaasen-livefront]

Approve vault change

[mkincaid-bw]

Default value should be NULL

Suggested change

	@AuthType TINYINT = 2
	@AuthType TINYINT = NULL

[mkincaid-bw]

Default value should be NULL

Suggested change

	@AuthType TINYINT = 2
	@AuthType TINYINT = NULL

[mkincaid-bw]

I see the updates now, LGTM