WIP

Author: RhysLees

src/Dto/Taxes/TaxDTO.php

@@ -0,0 +1,64 @@
+<?php
+
+namespace CodebarAg\Bexio\Dto\Taxes;
+
+use Exception;
+use Illuminate\Support\Arr;
+use Saloon\Http\Response;
+use Spatie\LaravelData\Data;
+
+class TaxDTO extends Data
+{
+    public function __construct(
+        public int $id,
+        public string $uuid,
+        public string $name,
+        public string $code,
+        public string $digit,
+        public string $type,
+        public int $account_id,
+        public string $tax_settlement_type,
+        public float $value,
+        public bool $is_active,
+        public string $display_name,
+        public ?int $start_year = null,
+        public ?int $end_year = null,
+        public mixed $net_tax_value = null,
+    ) {
+    }
+
+    public static function fromResponse(Response $response): self
+    {
+        if ($response->failed()) {
+            throw new \Exception('Failed to create DTO from Response');
+        }
+
+        $data = $response->json();
+
+        return self::fromArray($data);
+    }
+
+    public static function fromArray(array $data): self
+    {
+        if (! $data) {
+            throw new Exception('Unable to create DTO. Data missing from response.');
+        }
+
+        return new self(
+            id: Arr::get($data, 'id'),
+            uuid: Arr::get($data, 'uuid'),
+            name: Arr::get($data, 'name'),
+            code: Arr::get($data, 'code'),
+            digit: Arr::get($data, 'digit'),
+            type: Arr::get($data, 'type'),
+            account_id: Arr::get($data, 'account_id'),
+            tax_settlement_type: Arr::get($data, 'tax_settlement_type'),
+            value: Arr::get($data, 'value'),
+            is_active: Arr::get($data, 'is_active'),
+            display_name: Arr::get($data, 'display_name'),
+            start_year: Arr::get($data, 'start_year'),
+            end_year: Arr::get($data, 'end_year'),
+            net_tax_value: Arr::get($data, 'net_tax_value'),
+        );
+    }
+}

src/Requests/Taxes/DeleteATaxRequest.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace CodebarAg\Bexio\Requests\Taxes;
+
+use Exception;
+use Saloon\Enums\Method;
+use Saloon\Http\Request;
+use Saloon\Http\Response;
+
+class DeleteATaxRequest extends Request
+{
+    protected Method $method = Method::DELETE;
+
+    public function __construct(
+        readonly int $id,
+    ) {
+    }
+
+    public function resolveEndpoint(): string
+    {
+        return '/3.0/taxes/'.$this->id;
+    }
+
+    public function createDtoFromResponse(Response $response): mixed
+    {
+        if (! $response->successful()) {
+            throw new Exception('Request was not successful. Unable to create DTO.');
+        }
+
+        return $response->json();
+    }
+}

src/Requests/Taxes/FetchAListOfTaxesRequest.php

@@ -0,0 +1,67 @@
+<?php
+
+namespace CodebarAg\Bexio\Requests\Taxes;
+
+use CodebarAg\Bexio\Dto\Taxes\TaxDTO;
+use Exception;
+use Saloon\Enums\Method;
+use Saloon\Http\Request;
+use Saloon\Http\Response;
+
+class FetchAListOfTaxesRequest extends Request
+{
+    protected Method $method = Method::GET;
+
+    public function __construct(
+        readonly int $limit = 2000,
+        readonly int $offset = 0,
+        readonly ?string $scope = null,
+        readonly ?string $date = null,
+        readonly ?string $types = null,
+    ) {
+    }
+
+    public function resolveEndpoint(): string
+    {
+        return '/3.0/taxes';
+    }
+
+    public function defaultQuery(): array
+    {
+        $body = [
+            'limit' => $this->limit,
+            'offset' => $this->offset,
+        ];
+
+        if ($this->scope) {
+            $body['scope'] = $this->scope;
+        }
+
+        if ($this->date) {
+            $body['date'] = $this->date;
+        }
+
+        if ($this->types) {
+            $body['types'] = $this->types;
+        }
+
+        return $body;
+    }
+
+    public function createDtoFromResponse(Response $response): mixed
+    {
+        if (! $response->successful()) {
+            throw new Exception('Request was not successful. Unable to create DTO.');
+        }
+
+        $res = $response->json();
+
+        $taxes = collect();
+
+        foreach ($res as $currency) {
+            $taxes->push(TaxDTO::fromArray($currency));
+        }
+
+        return $taxes;
+    }
+}

src/Requests/Taxes/FetchATaxRequest.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace CodebarAg\Bexio\Requests\Taxes;
+
+use CodebarAg\Bexio\Dto\Taxes\TaxDTO;
+use Exception;
+use Saloon\Enums\Method;
+use Saloon\Http\Request;
+use Saloon\Http\Response;
+
+class FetchATaxRequest extends Request
+{
+    protected Method $method = Method::GET;
+
+    public function __construct(
+        readonly int $id,
+    ) {
+    }
+
+    public function resolveEndpoint(): string
+    {
+        return '/3.0/taxes/'.$this->id;
+    }
+
+    public function createDtoFromResponse(Response $response): mixed
+    {
+        if (! $response->successful()) {
+            throw new Exception('Request was not successful. Unable to create DTO.');
+        }
+
+        return TaxDTO::fromResponse($response);
+    }
+}

tests/Fixtures/Saloon/Taxes/fetch-a-list-of-taxes.json

@@ -0,0 +1 @@
+{"statusCode":200,"headers":{"Date":"Mon, 11 Dec 2023 17:03:04 GMT","Content-Type":"application\/json","Content-Length":"363","Connection":"keep-alive","ratelimit-reset":"57","x-ratelimit-remaining-minute":"999","x-ratelimit-limit-minute":"1000","ratelimit-remaining":"999","ratelimit-limit":"1000","etag":"a5f04d89c463c91d8fc844285bf2055e","Cache-Control":"no-store","pragma":"no-cache","vary":"Origin","access-control-allow-origin":"https:\/\/office.bexio.com","via":"1.1 google","alt-svc":"h3=\":443\"; ma=86400","CF-Cache-Status":"DYNAMIC","Server":"cloudflare","CF-RAY":"833f4c818cd4373e-FRA"},"data":"{\"id\":3,\"uuid\":\"b87bf4b2-db18-11e9-9d96-a4bf011ce47b\",\"name\":\"lib.model.tax.ch.sales_export.name\",\"code\":\"UEX\",\"digit\":\"220\",\"type\":\"not_taxable_turnover\",\"account_id\":127,\"tax_settlement_type\":\"none\",\"value\":0,\"net_tax_value\":null,\"start_year\":null,\"end_year\":null,\"is_active\":true,\"display_name\":\"UEX - Export\\\/Exempt 0.00%\",\"start_month\":null,\"end_month\":null}"}

tests/Fixtures/Saloon/Taxes/fetch-a-tax.json

@@ -15,7 +15,5 @@
 
     $response = $connector->send(new FetchExchangeRatesForCurrenciesRequest(id: 2));
 
-    ray($response->dto());
-
     $mockClient->assertSent(FetchExchangeRatesForCurrenciesRequest::class);
 });

tests/Requests/Currencies/FetchExchangeRatesForCurrenciesRequestTest.php

@@ -0,0 +1,19 @@
+<?php
+
+use CodebarAg\Bexio\BexioConnector;
+use CodebarAg\Bexio\Requests\Taxes\DeleteATaxRequest;
+use Saloon\Http\Faking\MockResponse;
+use Saloon\Laravel\Http\Faking\MockClient;
+
+it('can perform the request', closure: function () {
+    $mockClient = new MockClient([
+        DeleteATaxRequest::class => MockResponse::fixture('Taxes/delete-a-tax'),
+    ]);
+
+    $connector = new BexioConnector;
+    $connector->withMockClient($mockClient);
+
+    $response = $connector->send(new DeleteATaxRequest(id: null));
+
+    $mockClient->assertSent(DeleteATaxRequest::class);
+})->skip('WAITING FOR SETUP IN DEV ENVIRONMENT')->todo();

tests/Requests/Taxes/DeleteATaxRequestTest.php

@@ -0,0 +1,23 @@
+<?php
+
+use CodebarAg\Bexio\BexioConnector;
+use CodebarAg\Bexio\Requests\Taxes\FetchAListOfTaxesRequest;
+use Illuminate\Support\Collection;
+use Saloon\Http\Faking\MockResponse;
+use Saloon\Laravel\Http\Faking\MockClient;
+
+it('can perform the request', closure: function () {
+    $mockClient = new MockClient([
+        FetchAListOfTaxesRequest::class => MockResponse::fixture('Taxes/fetch-a-list-of-taxes'),
+    ]);
+
+    $connector = new BexioConnector;
+    $connector->withMockClient($mockClient);
+
+    $response = $connector->send(new FetchAListOfTaxesRequest());
+
+    $mockClient->assertSent(FetchAListOfTaxesRequest::class);
+
+    expect($response->dto())->toBeInstanceOf(Collection::class)
+        ->and($response->dto()->count())->toBe(40);
+});

tests/Requests/Taxes/FetchAListOfTaxesRequestTest.php

@@ -0,0 +1,19 @@
+<?php
+
+use CodebarAg\Bexio\BexioConnector;
+use CodebarAg\Bexio\Requests\Taxes\FetchATaxRequest;
+use Saloon\Http\Faking\MockResponse;
+use Saloon\Laravel\Http\Faking\MockClient;
+
+it('can perform the request', closure: function () {
+    $mockClient = new MockClient([
+        FetchATaxRequest::class => MockResponse::fixture('Taxes/fetch-a-tax'),
+    ]);
+
+    $connector = new BexioConnector;
+    $connector->withMockClient($mockClient);
+
+    $response = $connector->send(new FetchATaxRequest(id: 3));
+
+    $mockClient->assertSent(FetchATaxRequest::class);
+});