docs: updated to fat requests

docs/endpoint-collections.md

@@ -37,28 +37,27 @@ $payment = $mollie->payments->create([
 ]);
 ```
 
-**Advanced: Using typed payloads/queries**
-This approach provides full IDE support and type safety:
+**Advanced: Using typed array params**
+You can use dedicated `Data` objects to add partial type safety to your parameters.
+
 ```php
 use Mollie\Api\Http\Data\Money;
 use Mollie\Api\Http\Data\CreatePaymentPayload;
 
-$payment = $mollie->payments->create(
-    new CreatePaymentPayload(
-        description: 'My first API payment',
-        amount: new Money('EUR', '10.00')
-    )
-);
+$payment = $mollie->payments->create([
+    'description' => 'My first API payment',
+    'amount' => new Money('EUR', '10.00')
+]);
 ```
 
-If you have an array and need to interact with the payload or query, you can use a dedicated factory to convert the array into a typed class.
+If you're starting with an array and need to convert it into a structured request, you can use a specific factory designed for this purpose.
 
 ```php
 use Mollie\Api\Http\Data\Money;
-use Mollie\Api\Factories\CreatePaymentPayloadFactory;
+use Mollie\Api\Factories\CreatePaymentRequestFactory;
 
 // Fully untyped data
-$createPaymentPayload = CreatePaymentPayloadFactory::new([
+$createPaymentRequest = CreatePaymentRequestFactory::new([
     'amount' => [
         'currency' => 'EUR',
         'value' => '10.00'
@@ -67,16 +66,13 @@ $createPaymentPayload = CreatePaymentPayloadFactory::new([
 ]);
 
 // Partially untyped
-$createPaymentPayload = CreatePaymentPayloadFactory::new([
+$createPaymentRequest = CreatePaymentRequestFactory::new([
     'amount' => new Money('EUR', '10.00'),
     'description' => 'My first API payment'
 ]);
-
-// Access payload
-$createPaymentPayload->amount->...
 ```
 
-This approach allows you to seamlessly convert arrays into typed objects, providing better IDE support and type safety while working with your data.
+This method lets you effortlessly transform arrays into typed objects, thereby enhancing IDE support and increasing type safety while handling your data.
 
 # Available Endpoints
 

docs/requests.md

@@ -2,7 +2,7 @@
 
 ## Overview
 
-The Mollie API client uses request classes to communicate with the Mollie API. Each request class handles specific API endpoints and operations.
+The Mollie API client uses request classes to communicate with the Mollie API. Each request class handles specific API endpoints and operations. The response is casted into a dedicated `Mollie\Api\Resources\*` class.
 
 ## Sending a Request
 
@@ -25,24 +25,18 @@ To send a request using the Mollie API client, you typically need to:
    ```php
    use Mollie\Api\MollieApiClient;
    use Mollie\Api\Http\Data\Money;
-   use Mollie\Api\Http\Data\CreatePaymentPayload;
    use Mollie\Api\Http\Requests\CreatePaymentRequest;
 
    $mollie = new MollieApiClient();
    $createPaymentRequest = new CreatePaymentRequest(
-       new CreatePaymentPayload(
-           'Test payment',
-           new Money('EUR', '10.00'),
-           'https://example.org/redirect',
-           'https://example.org/webhook'
-       )
+        'Test payment',
+        new Money('EUR', '10.00'),
+        'https://example.org/redirect',
+        'https://example.org/webhook'
    );
 
-   /** @var \Mollie\Api\Http\Response $response */
-   $response = $mollie->send($createPaymentRequest);
+   /** @var \Mollie\Api\Resources\Payment $payment */
+   $payment = $mollie->send($createPaymentRequest);
 
-   $this->assertEquals(200, $response->status());
-
-   /** @var \Mollie\Api\Resources\Payment */
-   $payment = $response->toResource();
+   $this->assertEquals(200, $payment->getResponse()->status());
    ```

src/Contracts/Resolvable.php

@@ -2,6 +2,4 @@
 
 namespace Mollie\Api\Contracts;
 
-interface Resolvable extends Arrayable
-{
-}
+interface Resolvable extends Arrayable {}

src/EndpointCollection/SessionEndpointCollection.php

@@ -4,18 +4,14 @@
 
 use Mollie\Api\Exceptions\RequestException;
 use Mollie\Api\Factories\SortablePaginatedQueryFactory;
-use Mollie\Api\Http\Requests\CancelSessionRequest;
 use Mollie\Api\Http\Requests\DynamicDeleteRequest;
 use Mollie\Api\Http\Requests\DynamicGetRequest;
 use Mollie\Api\Http\Requests\DynamicPaginatedRequest;
 use Mollie\Api\Http\Requests\DynamicPostRequest;
 use Mollie\Api\Http\Requests\DynamicPutRequest;
-use Mollie\Api\Http\Requests\GetPaginatedSessionsRequest;
-use Mollie\Api\Http\Requests\UpdateSessionRequest;
 use Mollie\Api\Resources\LazyCollection;
 use Mollie\Api\Resources\Session;
 use Mollie\Api\Resources\SessionCollection;
-use Mollie\Api\Utils\Arr;
 
 class SessionEndpointCollection extends EndpointCollection
 {
@@ -54,7 +50,6 @@ public function create(array $payload = [], array $query = []): Session
      *
      * Will throw a ApiException if the session id is invalid or the resource cannot be found.
      *
-     * @param  array  $payload
      *
      * @throws RequestException
      */
@@ -97,6 +92,8 @@ public function page(?string $from = null, ?int $limit = null, array $filters =
 
         $request = new DynamicPaginatedRequest('sessions', array_merge($filters, $query->toArray()));
 
+        $request->setHydratableResource(SessionCollection::class);
+
         /** @var SessionCollection */
         return $this->send($request);
     }
@@ -121,6 +118,8 @@ public function iterator(
 
         $request = new DynamicPaginatedRequest('sessions', array_merge($filters, $query->toArray()));
 
+        $request->setHydratableResource(SessionCollection::class);
+
         return $this->send(
             $request
                 ->useIterator()

src/Exceptions/ClientException.php

@@ -2,6 +2,4 @@
 
 namespace Mollie\Api\Exceptions;
 
-class ClientException extends RequestException
-{
-}
+class ClientException extends RequestException {}

src/Exceptions/EmbeddedResourcesNotParseableException.php

@@ -2,6 +2,4 @@
 
 namespace Mollie\Api\Exceptions;
 
-class EmbeddedResourcesNotParseableException extends MollieException
-{
-}
+class EmbeddedResourcesNotParseableException extends MollieException {}

src/Exceptions/LogicException.php

@@ -2,6 +2,4 @@
 
 namespace Mollie\Api\Exceptions;
 
-class LogicException extends MollieException
-{
-}
+class LogicException extends MollieException {}

src/Exceptions/MollieException.php

@@ -4,6 +4,4 @@
 
 use Psr\Http\Client\ClientExceptionInterface;
 
-abstract class MollieException extends \Exception implements ClientExceptionInterface
-{
-}
+abstract class MollieException extends \Exception implements ClientExceptionInterface {}

src/Exceptions/ServerException.php

@@ -2,6 +2,4 @@
 
 namespace Mollie\Api\Exceptions;
 
-class ServerException extends RequestException
-{
-}
+class ServerException extends RequestException {}

src/Exceptions/UnrecognizedClientException.php

@@ -2,6 +2,4 @@
 
 namespace Mollie\Api\Exceptions;
 
-class UnrecognizedClientException extends MollieException
-{
-}
+class UnrecognizedClientException extends MollieException {}

src/Http/Requests/DynamicDeleteRequest.php

@@ -2,9 +2,10 @@
 
 namespace Mollie\Api\Http\Requests;
 
+use Mollie\Api\Contracts\SupportsTestmodeInQuery;
 use Mollie\Api\Types\Method;
 
-class DynamicDeleteRequest extends DynamicRequest
+class DynamicDeleteRequest extends DynamicRequest implements SupportsTestmodeInQuery
 {
     /**
      * Define the HTTP method.

src/Http/Requests/DynamicGetRequest.php

@@ -2,9 +2,10 @@
 
 namespace Mollie\Api\Http\Requests;
 
+use Mollie\Api\Contracts\SupportsTestmodeInQuery;
 use Mollie\Api\Types\Method;
 
-class DynamicGetRequest extends DynamicRequest
+class DynamicGetRequest extends DynamicRequest implements SupportsTestmodeInQuery
 {
     /**
      * Define the HTTP method.

src/Http/Requests/DynamicPaginatedRequest.php

@@ -3,9 +3,10 @@
 namespace Mollie\Api\Http\Requests;
 
 use Mollie\Api\Contracts\IsIteratable;
+use Mollie\Api\Contracts\SupportsTestmodeInQuery;
 use Mollie\Api\Traits\IsIteratableRequest;
 
-class DynamicPaginatedRequest extends DynamicGetRequest implements IsIteratable
+class DynamicPaginatedRequest extends DynamicGetRequest implements IsIteratable, SupportsTestmodeInQuery
 {
     use IsIteratableRequest;
 }

src/Http/Requests/DynamicPostRequest.php

@@ -3,10 +3,11 @@
 namespace Mollie\Api\Http\Requests;
 
 use Mollie\Api\Contracts\HasPayload;
+use Mollie\Api\Contracts\SupportsTestmodeInPayload;
 use Mollie\Api\Traits\HasJsonPayload;
 use Mollie\Api\Types\Method;
 
-class DynamicPostRequest extends DynamicRequest implements HasPayload
+class DynamicPostRequest extends DynamicRequest implements HasPayload, SupportsTestmodeInPayload
 {
     use HasJsonPayload;
 

src/Http/Requests/DynamicPutRequest.php

@@ -3,10 +3,11 @@
 namespace Mollie\Api\Http\Requests;
 
 use Mollie\Api\Contracts\HasPayload;
+use Mollie\Api\Contracts\SupportsTestmodeInPayload;
 use Mollie\Api\Traits\HasJsonPayload;
 use Mollie\Api\Types\Method;
 
-class DynamicPutRequest extends DynamicRequest implements HasPayload
+class DynamicPutRequest extends DynamicRequest implements HasPayload, SupportsTestmodeInPayload
 {
     use HasJsonPayload;
 

src/Http/Requests/DynamicRequest.php

@@ -2,10 +2,14 @@
 
 namespace Mollie\Api\Http\Requests;
 
+use Mollie\Api\Resources\AnyResource;
+
 abstract class DynamicRequest extends ResourceHydratableRequest
 {
     private string $url;
 
+    protected $hydratableResource = AnyResource::class;
+
     public function __construct(string $url)
     {
         $this->url = $url;

src/Resources/AnyResource.php

@@ -2,15 +2,16 @@
 
 namespace Mollie\Api\Resources;
 
+use Mollie\Api\Contracts\Arrayable;
 use Mollie\Api\Utils\Arr;
 use stdClass;
 
 /**
  * @property \Mollie\Api\MollieApiClient $connector
  */
-class AnyResource extends BaseResource
+class AnyResource extends BaseResource implements Arrayable
 {
-    public array $attributes = [];
+    protected array $attributes = [];
 
     /**
      * @return mixed
@@ -27,4 +28,9 @@ public function fill($attributes): void
     {
         $this->attributes = $attributes instanceof stdClass ? (array) $attributes : $attributes;
     }
+
+    public function toArray(): array
+    {
+        return $this->attributes;
+    }
 }

src/Resources/IssuerCollection.php

@@ -2,6 +2,4 @@
 
 namespace Mollie\Api\Resources;
 
-class IssuerCollection extends BaseCollection
-{
-}
+class IssuerCollection extends BaseCollection {}