feat(demo): add story 1 — Sorano: Rock and Time

2026-06-20 21:19:57 +02:00
parent 42ed59a6b3
commit 8f87155c1d
5508 changed files with 1595740 additions and 124 deletions
@@ -0,0 +1,61 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Grav\Plugin\Api\Response;
+
+use Grav\Framework\Psr7\Response;
+use Grav\Plugin\Api\Exceptions\ApiException;
+use Grav\Plugin\Api\Exceptions\ValidationException;
+use Psr\Http\Message\ResponseInterface;
+
+/**
+ * RFC 7807 Problem Details response builder.
+ */
+class ErrorResponse
+{
+    /**
+     * @param array<string,mixed>      $headers
+     * @param array<string,mixed>|null $toast  Optional toast hint honored by Admin
+     *   Next: { message?, type?, duration?, dismissible? }. `duration` is in ms;
+     *   use 0 (or dismissible:true) for a toast that stays until manually closed.
+     */
+    public static function create(int $status, string $title, string $detail, array $headers = [], ?array $toast = null): ResponseInterface
+    {
+        $body = [
+            'status' => $status,
+            'title' => $title,
+            'detail' => $detail,
+        ];
+        if ($toast !== null) {
+            $body['toast'] = $toast;
+        }
+
+        $headers = array_merge($headers, [
+            'Content-Type' => 'application/problem+json',
+            'Cache-Control' => 'no-store, max-age=0',
+        ]);
+
+        return new Response($status, $headers, json_encode($body, JSON_UNESCAPED_SLASHES));
+    }
+
+    public static function fromException(ApiException $e): ResponseInterface
+    {
+        $body = [
+            'status' => $e->getStatusCode(),
+            'title' => $e->getErrorTitle(),
+            'detail' => $e->getMessage(),
+        ];
+
+        if ($e instanceof ValidationException && $e->getValidationErrors()) {
+            $body['errors'] = $e->getValidationErrors();
+        }
+
+        $headers = array_merge($e->getHeaders(), [
+            'Content-Type' => 'application/problem+json',
+            'Cache-Control' => 'no-store, max-age=0',
+        ]);
+
+        return new Response($e->getStatusCode(), $headers, json_encode($body, JSON_UNESCAPED_SLASHES));
+    }
+}