Added Points endpoint & migrated to saloon v3

README.md

@@ -157,7 +157,7 @@ Mautic::segments()->addContact($segmentId, $contactId);
 
 //Create a contact and add it to a segment
 $response = Mautic::contacts()->create(strtolower($request->input('email')));
-if (!$response->failed())
+if ($response && !$response->failed())
 {
     $contactId = $response->object()->contact->id;
     Mautic::segments()->addContact(4, $contactId);//4 is the segment ID, change it to your needs
@@ -192,6 +192,25 @@ Mautic::utmTags()->addUtmTag($contactId, $data);
 Mautic::utmTags()->removeUtmTag($utmId, $contactId);
 ```
 
+#### Managing Contacts points
+```php
+use Combindma\Mautic\Facades\Mautic;
+
+//Add contact points
+$data = array(
+    'eventName' => 'Score via api',
+    'actionName' => 'Adding',
+ );
+
+Mautic::points()->addPoints($contactId, 10, $data);//$data is optional
+
+//Subtract contact points
+$data = array(
+    'eventname' => 'Score via api',
+    'actionname' => 'Subtracting',
+ );
+Mautic::points()->subtractPoints($contactId, 10, $data);//$data is optional
+```
 
 #### Macrobale
 Communicating with the API can become a repetitive process. that's why we made this package macroable.
@@ -202,7 +221,7 @@ use Combindma\Mautic\Facades\Mautic;
 //include this in your macrobale file
 Mautic::macro('subscribe', function(string $email) {
     $response = Mautic::contacts()->create(strtolower($request->input('email')));
-    if (!$response->failed())
+    if ($response && !$response->failed())
     {
         $contactId = $response->object()->contact->id;
         Mautic::segments()->addContact(4, $contactId);//4 is the segment ID, change it to your needs

composer.json

@@ -19,7 +19,7 @@
         "php": "^8.1",
         "guzzlehttp/guzzle": "^7.5",
         "illuminate/contracts": "^10.0",
-        "sammyjo20/saloon": "^2.5",
+        "saloonphp/laravel-plugin": "^3.0",
         "spatie/laravel-package-tools": "^1.14.0"
     },
     "require-dev": {

src/Mautic.php

@@ -3,6 +3,7 @@
 namespace Combindma\Mautic;
 
 use Combindma\Mautic\Resources\ContactResource;
+use Combindma\Mautic\Resources\PointsResource;
 use Combindma\Mautic\Resources\SegmentResource;
 use Combindma\Mautic\Resources\UtmResource;
 use Combindma\Mautic\Traits\MauticStorage;
@@ -15,9 +16,9 @@
 
 class Mautic extends Connector
 {
-    use MauticStorage;
     use AlwaysThrowOnErrors;
     use Macroable;
+    use MauticStorage;
 
     private readonly string $version;
 
@@ -58,6 +59,11 @@ public function utmTags(): UtmResource
         return new UtmResource($this);
     }
 
+    public function points(): PointsResource
+    {
+        return new PointsResource($this);
+    }
+
     protected function defaultAuth(): ?Authenticator
     {
         if ($this->version === 'BasicAuth') {

src/MauticServiceProvider.php

@@ -16,7 +16,7 @@ public function configurePackage(Package $package): void
             ->hasRoute('web');
     }
 
-    public function packageRegistered()
+    public function packageRegistered(): void
     {
         $this->app->singleton('laravel-mautic', function () {
             return new Mautic();

src/Requests/AddPointsToContactRequest.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace Combindma\Mautic\Requests;
+
+use Saloon\Contracts\Body\HasBody;
+use Saloon\Enums\Method;
+use Saloon\Http\Request;
+use Saloon\Traits\Body\HasJsonBody;
+
+class AddPointsToContactRequest extends Request implements HasBody
+{
+    use HasJsonBody;
+
+    protected Method $method = Method::POST;
+
+    public function __construct(protected int $contactId, protected int $pointDelta, protected ?array $attributes = null)
+    {
+        //
+    }
+
+    public function resolveEndpoint(): string
+    {
+        return '/contacts/'.$this->contactId.'/points/plus/'.$this->pointDelta;
+    }
+
+    protected function defaultBody(): array
+    {
+        return $this->attributes ?? [];
+    }
+}

src/Requests/RemovePointsFromContactRequest.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace Combindma\Mautic\Requests;
+
+use Saloon\Enums\Method;
+use Saloon\Http\Request;
+
+class RemovePointsFromContactRequest extends Request
+{
+    protected Method $method = Method::POST;
+
+    public function __construct(protected int $contactId, protected int $pointDelta, protected ?array $attributes = null)
+    {
+        //
+    }
+
+    public function resolveEndpoint(): string
+    {
+        return '/contacts/'.$this->contactId.'/points/minus/'.$this->pointDelta;
+    }
+
+    protected function defaultBody(): array
+    {
+        return $this->attributes ?? [];
+    }
+}

src/Resources/PointsResource.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace Combindma\Mautic\Resources;
+
+use Combindma\Mautic\Requests\AddPointsToContactRequest;
+use Combindma\Mautic\Requests\RemovePointsFromContactRequest;
+use Exception;
+use Illuminate\Support\Facades\Log;
+use Saloon\Http\Response;
+
+class PointsResource extends Resource
+{
+    public function addPoints(int $contactId, int $pointDelta, ?array $attributes = null): ?Response
+    {
+        if ($this->connector->isApiDisabled()) {
+            return null;
+        }
+
+        try {
+            return $this->connector->send(new AddPointsToContactRequest($contactId, $pointDelta, $attributes));
+        } catch (Exception $e) {
+            Log::error($e);
+        }
+
+        return null;
+    }
+
+    public function subtractPoints(int $contactId, int $pointDelta, ?array $attributes = null): ?Response
+    {
+        if ($this->connector->isApiDisabled()) {
+            return null;
+        }
+
+        try {
+            return $this->connector->send(new RemovePointsFromContactRequest($contactId, $pointDelta, $attributes));
+        } catch (Exception $e) {
+            Log::error($e);
+        }
+
+        return null;
+    }
+}