add endpoint to fetch all projects

Author: Nielsvanpach

README.md

@@ -74,6 +74,21 @@ public function user(Harvest $harvest): array
 }
 ```
 
+## Projects
+
+###  Retrieve all projects
+
+```php
+use Spatie\Harvest\Harvest;
+use Spatie\Harvest\Resources\ProjectResource;
+
+/** @return array<ProjectResource> */
+public function user(Harvest $harvest): array
+{
+    return $harvest->projects()->all();
+}
+```
+
 
 ## Testing
 

src/Groups/ProjectGroup.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Spatie\Harvest\Groups;
+
+use Saloon\Http\BaseResource;
+use Saloon\Http\Response;
+use Spatie\Harvest\Requests\GetProjects;
+
+class ProjectGroup extends BaseResource
+{
+    public function all(): Response
+    {
+        return $this->connector->send(new GetProjects());
+    }
+}

src/Harvest.php

@@ -4,6 +4,7 @@
 
 use Saloon\Http\Auth\TokenAuthenticator;
 use Saloon\Http\Connector;
+use Spatie\Harvest\Groups\ProjectGroup;
 use Spatie\Harvest\Groups\UserGroup;
 
 class Harvest extends Connector
@@ -36,4 +37,9 @@ public function users(): UserGroup
     {
         return new UserGroup($this);
     }
+
+    public function projects(): ProjectGroup
+    {
+        return new ProjectGroup($this);
+    }
 }

src/Requests/GetProjects.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Spatie\Harvest\Requests;
+
+use Saloon\Enums\Method;
+use Saloon\Http\Request;
+use Saloon\Http\Response;
+use Spatie\Harvest\Resources\ProjectResource;
+
+class GetProjects extends Request
+{
+    public Method $method = Method::GET;
+
+    public function resolveEndpoint(): string
+    {
+        return '/projects';
+    }
+
+    /** @return array<ProjectResource> */
+    public function createDtoFromResponse(Response $response): array
+    {
+        return array_map(
+            fn (array $object) => ProjectResource::createFromResponse($object),
+            $response->json()
+        );
+    }
+}

src/Resources/ProjectResource.php

@@ -0,0 +1,66 @@
+<?php
+
+namespace Spatie\Harvest\Resources;
+
+use Carbon\CarbonImmutable;
+
+class ProjectResource
+{
+    public function __construct(
+        public int $id,
+        public object $client,
+        public string $name,
+        public string $code,
+        public bool $isActive,
+        public bool $isBillable,
+        public bool $isFixedFee,
+        public string $billBy,
+        public ?float $hourlyRate,
+        public ?float $budget,
+        public string $budgetBy,
+        public bool $budgetIsMonthly,
+        public bool $notifyWhenOverBudget,
+        public ?float $overBudgetNotificationPercentage,
+        public ?CarbonImmutable $overBudgetNotificationDate,
+        public bool $showBudgetToAll,
+        public ?float $costBudget,
+        public bool $costBudgetIncludeExpenses,
+        public ?float $fee,
+        public ?string $notes,
+        public ?CarbonImmutable $startsOn,
+        public ?CarbonImmutable $endsOn,
+        public CarbonImmutable $createdAt,
+        public CarbonImmutable $updatedAt,
+    ) {}
+
+    /** @param array<string, mixed> $response */
+    public static function createFromResponse(array $response): self
+    {
+        return new self(
+            id: $response['id'],
+            client: (object) $response['client'],
+            name: $response['name'],
+            code:  $response['code'],
+            isActive: $response['is_active'],
+            isBillable: $response['is_billable'],
+            isFixedFee: $response['is_fixed_fee'],
+            billBy: $response['bill_by'],
+            hourlyRate: $response['hourly_rate'] ?? null,
+            budget: $response['budget'] ?? null,
+            budgetBy: $response['budget_by'],
+            budgetIsMonthly: $response['budget_is_monthly'],
+            notifyWhenOverBudget: $response['notify_when_over_budget'],
+            overBudgetNotificationPercentage: $response['over_budget_notification_percentage'] ?? null,
+            overBudgetNotificationDate: isset($response['over_budget_notification_date']) ? CarbonImmutable::parse($response['over_budget_notification_date']) : null,
+            showBudgetToAll: $response['show_budget_to_all'],
+            costBudget: $response['cost_budget'] ?? null,
+            costBudgetIncludeExpenses: $response['cost_budget_include_expenses'],
+            fee: $response['fee'] ?? null,
+            notes: !empty($response['notes']) ? $response['notes'] : null,
+            startsOn: isset($response['starts_on']) ? CarbonImmutable::parse($response['starts_on']) : null,
+            endsOn: isset($response['ends_on']) ? CarbonImmutable::parse($response['ends_on']) : null,
+            createdAt: CarbonImmutable::parse($response['created_at']),
+            updatedAt: CarbonImmutable::parse($response['updated_at']),
+        );
+    }
+}