Saloon Integration (phpdevkits style)

Saloon Integration (phpdevkits style)

Use this skill when working inside a SaloonPHP-based SDK in this repo's shape — single Connector extending Saloon's Connector, organized by Resources/ + Requests/ + Data/ + Enums/ + Exceptions/, with recorded Saloon fixtures driving Pest tests at 100% coverage.

For general Pest / factory conventions that aren't Saloon-specific (no it(), factories under tests/Factories/, exception-test styles), see the pest-package-tests skill — this skill assumes those and only covers the Saloon side.

Quick start

A minimal slice (one resource, one request, one DTO, one fixture-backed test):

// src/Data/Widget.php
final readonly class Widget implements JsonSerializable {
    public function __construct(public string $id, public string $name) {}
    public static function from(array $data): self { /* hydration + validation */ }
    public function jsonSerialize(): array { /* snake_case */ }
}

// src/Requests/GetWidget.php
final class GetWidget extends Request {
    protected Method $method = Method::GET;
    public function __construct(private readonly int|string $id) {}
    #[Override] public function resolveEndpoint(): string {
        return sprintf('/widgets/%s', $this->id);
    }
}

// src/Resources/WidgetResource.php
final class WidgetResource extends BaseResource {
    public function get(): Widget {
        $data = $this->connector->send(new GetWidget($this->id))->json('data');
        return Widget::from($data);
    }
}