Sync with Mautic 5 upstream + Webmecanik features (4.0.0)

[Hugo-Prossaird]

Summary

Sync with Mautic 5 upstream and add Webmecanik-specific features for version 4.0.0.

Changes

• PSR-18 HTTP Client: Now uses PSR-18 compatible HTTP client instead of cURL
• PHP 8.0+ Required: Minimum PHP version is now 8.0
• TwoLeggedOAuth2: Added client credentials OAuth2 authentication (PSR-18 compatible)
• sendCustomToContact: Send custom emails to contacts without pre-defined templates
• Contacts API: Added optional query arguments for Custom Objects support
• Point Groups API: New API context for Mautic 5.x point groups

PHP Examples

TwoLeggedOAuth2 (Client Credentials)

use Mautic\Auth\ApiAuth;
use Mautic\MauticApi;

$settings = [
    'baseUrl'      => 'https://mautic.example.com',
    'clientKey'    => 'your_client_id',
    'clientSecret' => 'your_client_secret',
];

$auth = (new ApiAuth())->newAuth($settings, 'TwoLeggedOAuth2');
$api = (new MauticApi())->newApi('contacts', $auth, $settings['baseUrl'] . '/api/');

// Token management
if (!$auth->isAuthorized()) {
    $auth->requestAccessToken();
}
$tokenData = $auth->getAccessTokenData(); // For caching

sendCustomToContact

$emailApi = (new MauticApi())->newApi('emails', $auth, $apiUrl);

$response = $emailApi->sendCustomToContact($contactId, [
    'fromEmail' => 'noreply@example.com',
    'fromName'  => 'My App',
    'subject'   => 'Hello {{contactfield=firstname}}!',
    'content'   => '<p>Custom HTML content with tokens</p>',
]);

if ($response['success']) {
    echo "Email sent! Tracking hash: " . $response['trackingHash'];
}

Note: This feature requires Mautic with PR #12854 merged.
It is not available in standard Mautic 5.x releases.

Contacts with Custom Objects query args

$contactApi = (new MauticApi())->newApi('contacts', $auth, $apiUrl);

// Create with query arguments for Custom Objects
$response = $contactApi->create(
    ['email' => 'test@example.com', 'firstname' => 'John'],
    ['includeCustomObjects' => true]
);

Point Groups API (Mautic 5.x)

$contactApi = (new MauticApi())->newApi('contacts', $auth, $apiUrl);

// Get point group scores
$scores = $contactApi->getPointGroupScores($contactId);

// Add/subtract points
$contactApi->addPointGroupScore($contactId, $groupId, 10);
$contactApi->subtractPointGroupScore($contactId, $groupId, 5);

Test plan

• All PHPUnit tests pass
• PHPStan static analysis passes
• PHP-CS-Fixer code style passes
• TwoLeggedOAuth2 authentication works
• sendCustomToContact tested with kuzmany/mautic fork (PR #12854)
• Contacts create/createBatch with query args works
• Backward compatibility with existing code

🤖 Generated with Claude Code