[APIView] Namespace Email Notification Story

[AlitzelMendez]

Add email/notification support for namespace lifecycle events in the APIView Namespace Approval tab. Architects and SDK teams need to be kept in the loop when namespace status changes or action is needed.

Background

PR #14632 introduced the Namespace Approval tab to APIView, which allows architects to approve, reject, or track namespace proposals per language. As part of that work, the following notification scenarios were identified and deferred.

Proposed Notifications

1. Namespace Removed

• Trigger: A namespace is completely removed
• Recipients: The responsible architect(s) for the language(s) affected.
• Email content: Notify which namespace was removed, which package/project it belonged to, and who initiated the change.

2. "Request Review" Button

• Feature: Add a Request Review button on the Namespace tab (visible to SDK owners / package authors), just exclude architects/deputy architects and Admins).
• Trigger: User clicks the button to request architect review of a proposed namespace.
• Recipients: The language architect(s) for the relevant language.
• Email content: Package name, proposed namespace, link to the Namespace tab in APIView.
• Concern: Provide feedback / disable the button temporarily to avoid this becoming super noise

3. New Namespace Proposed

• Trigger: A new namespace is proposed for a language in a project.
• Recipients: The language architect(s) for the proposed language.
• Email content:
  • Package name and proposed namespace.
  • Links to the Namespace tab.
  • If a previous namespace for the same language/project was withdrawn, include the historical namespace data in the email body for context.

Related

• PR: [APIView] Add Namespace Approval Tab to APIView #14632 — Add Namespace Approval Tab to APIView
• Issue: [APIView] Project-level namespace review UI #14427