mirror of
https://github.com/anikeen-com/id.git
synced 2026-11-04 22:59:41 +00:00
Maurice PreußandClaude Opus 5.5
57ce0b4a79
Requests with the user's token threw a bare ResourceException with a message like "… for resource [Anikeen\Id\Resources\Order]" and no error code, while app requests threw ApiException. Both throw ApiException now: status (also getCode()), Anikeen ID's error code and message, isNotFound(), isConflict(), isTemporary(). Failed lists throw CollectionException, now a subclass of ApiException. A request without a response (connection refused, timeout) throws ApiException with status 0 instead of a Guzzle exception. ApiException extends ResourceException, so existing catch blocks keep working. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
97 lines
2.2 KiB
PHP
97 lines
2.2 KiB
PHP
<?php
|
|
|
|
namespace Anikeen\Id\Resources;
|
|
|
|
use Anikeen\Id\AnikeenId;
|
|
use Anikeen\Id\Exceptions\CollectionException;
|
|
use Anikeen\Id\Helpers\Paginator;
|
|
use Anikeen\Id\Result;
|
|
use Closure;
|
|
use GuzzleHttp\Exception\GuzzleException;
|
|
use GuzzleHttp\Psr7\Response;
|
|
use JsonSerializable;
|
|
use Throwable;
|
|
|
|
/**
|
|
* @property bool $success
|
|
* @property mixed $data
|
|
* @property int $total
|
|
* @property int $status
|
|
* @property null|array $links
|
|
* @property null|array $meta
|
|
* @property null|Paginator $paginator
|
|
* @property AnikeenId $anikeenId
|
|
* @property Response $response
|
|
* @property null|Throwable $exception
|
|
*/
|
|
#[\AllowDynamicProperties]
|
|
abstract class BaseCollection implements JsonSerializable
|
|
{
|
|
private Closure $callable;
|
|
public ?Result $result = null;
|
|
|
|
/**
|
|
* @throws CollectionException
|
|
*/
|
|
protected function __construct(callable $callable)
|
|
{
|
|
try {
|
|
$this->result = $callable();
|
|
} catch (GuzzleException $e) {
|
|
// no response at all (connection refused, timeout)
|
|
throw CollectionException::unreachable($e);
|
|
}
|
|
|
|
if (!$this->result->success()) {
|
|
throw CollectionException::fromResult($this->result);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @throws CollectionException
|
|
*/
|
|
public static function builder(callable $callable): static
|
|
{
|
|
return new static($callable, false);
|
|
}
|
|
|
|
/**
|
|
* Returns the collection of resources as an array.
|
|
*/
|
|
public function toArray(): array
|
|
{
|
|
return (array)$this->result->data;
|
|
}
|
|
|
|
/**
|
|
* Returns the collection of resources as a JSON string.
|
|
*/
|
|
public function jsonSerialize(): array
|
|
{
|
|
return $this->toArray();
|
|
}
|
|
|
|
/**
|
|
* Returns the collection of resources.
|
|
*/
|
|
public function paginate(): Result
|
|
{
|
|
return $this->result;
|
|
}
|
|
|
|
/**
|
|
* Returns the Resource based on the ID.
|
|
*/
|
|
abstract public function find(string $id): ?BaseResource;
|
|
|
|
public function __get(string $name)
|
|
{
|
|
return $this->result->{$name} ?? null;
|
|
}
|
|
|
|
public function __isset(string $name): bool
|
|
{
|
|
return isset($this->result->{$name});
|
|
}
|
|
}
|