PHPAY-29: feat: efi list all charges

.gitignore

@@ -1,4 +1,5 @@
 vendor/
 node_modules/
 examples/asaas/credentials.php
-examples/efi/credentials.php
+examples/efi/credentials.php
+.idea/

examples/efi/charges.php

@@ -28,3 +28,17 @@
     ->charge($charge)
     ->setCustomer($customer)
     ->create();
+
+/**
+ * get all charges
+ * @return array charges
+ */
+$phpay
+    ->charge()
+    ->setQueryParams([
+        'charge_type' => 'billet',
+        'begin_date'  => '2024-11-01',
+        'end_date'    => '2024-11-30',
+        'status'      => 'unpaid',
+    ])
+    ->getAll();

src/Gateways/Efi/Resources/Charge/Charge.php

@@ -28,6 +28,11 @@ class Charge implements ChargeInterface
      */
     private array $items = [];
 
+    /**
+     * @var array<mixed>
+     */
+    private array $queryParams = [];
+
     /**
      * @var array<mixed>
      */
@@ -68,6 +73,30 @@ public function setCustomer(array $customer): Charge
         return $this;
     }
 
+    /**
+     * set filters
+     *
+     * @param array<mixed> $queryParams
+     * @return ChargeInterface
+     * @deprecated
+     */
+    public function setQueryParams(array $queryParams): ChargeInterface
+    {
+        $this->queryParams = $queryParams;
+
+        return $this;
+    }
+
+    /**
+     * find all charges
+     *
+     * @return array<array|mixed>
+     */
+    public function getAll(): array
+    {
+        return $this->get('v1/charges', $this->queryParams);
+    }
+
     /**
      * create charge
      *

src/Gateways/Efi/Resources/Charge/Interface/ChargeInterface.php

@@ -6,11 +6,26 @@
 
 interface ChargeInterface
 {
+    /**
+     * get all charges
+     *
+     * @return array<array|mixed>
+     */
+    public function getAll(): array;
+
     /**
      * set customer
      *
      * @param array<mixed> $customer
      * @return Charge
      */
     public function setCustomer(array $customer): Charge;
+
+    /**
+     * set query params
+     *
+     * @param array<mixed> $queryParams
+     * @return ChargeInterface
+     */
+    public function setQueryParams(array $queryParams): ChargeInterface;
 }