Add Microsoft Graph Mail Transport and Configuration

[sanjacornelius]

This PR introduces Microsoft Graph mail support, allowing emails to be sent through the Microsoft Graph API.

Changes

• Added MicrosoftGraphTransport to send emails through the Microsoft Graph sendMail endpoint.
• Added MicrosoftGraphMessageConverter to convert mail messages into the payload required by the Graph API.
• Added MicrosoftGraphTokenProvider to retrieve Microsoft Graph access tokens.
• Updated OauthMailManager to support Microsoft Graph through:
  - createTransport()
  - createMicrosoftGraphTransport()
• Registered the microsoft_graph mailer in config/mail.php.
• Added error handling to throw a TransportException when the Graph API returns an unsuccessful HTTP response.

How to Test

Test Email Server Configuration

1. Create a new Email Server using microsoft_graph as the driver
2. Complete all required Microsoft Graph configuration fields
3. Authorize the Microsoft Graph connection
4. Select "Send Test Email"
5. Confirm that the test email is sent successfully

Test Send Email Connector

1. Create a new process containing a Send Email connector
2. Configure the connector to use the Microsoft Graph Email Server created above
3. Run the process
4. Confirm that the email is sent successfully to the configured recipient

Related Tickets & Packages

• FOUR-32165

ci:connector-send-email:subtask/FOUR-32165
ci:deploy
.

Code Review Checklist

• I have pulled this code locally and tested it on my instance, along with any associated packages.
• This code adheres to ProcessMaker Coding Guidelines.
• This code includes a unit test or an E2E test that tests its functionality, or is covered by an existing test.
• This solution fixes the bug reported in the original ticket.
• This solution does not alter the expected output of a component in a way that would break existing Processes.
• This solution does not implement any breaking changes that would invalidate documentation or cause existing Processes to fail.
• This solution has been tested with enterprise packages that rely on its functionality and does not introduce bugs in those packages.
• This code does not duplicate functionality that already exists in the framework or in ProcessMaker.
• This ticket conforms to the PRD associated with this part of ProcessMaker.

[vladyrichter]

QA server K8S was successfully deployed https://ci-9a5e85c03c.engk8s.processmaker.net

[vladyrichter]

QA server K8S was successfully deployed https://ci-9a5e85c03c.engk8s.processmaker.net

[processmaker-sonarqube]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
No data about Coverage
No data about Duplication

See analysis details on SonarQube

[vladyrichter]

QA server K8S was successfully deployed https://ci-9a5e85c03c.engk8s.processmaker.net