Setup contract for Saga repository handling

Author: Jeroen de Graaf

src/EventStore/Saga/RdbmsSaga.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Gember\DependencyContracts\EventStore\Saga;
+
+use Stringable;
+use DateTimeImmutable;
+
+final readonly class RdbmsSaga
+{
+    public function __construct(
+        public string $sagaName,
+        public string|Stringable $sagaId,
+        public string $payload,
+        public DateTimeImmutable $createdAt,
+        public ?DateTimeImmutable $updatedAt,
+    ) {}
+}

src/EventStore/Saga/RdbmsSagaNotFoundException.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Gember\DependencyContracts\EventStore\Saga;
+
+use Exception;
+use Stringable;
+
+final class RdbmsSagaNotFoundException extends Exception
+{
+    public static function withSagaId(string $sagaName, string|Stringable $sagaId): self
+    {
+        return new self(sprintf("Saga '%s' with id %s not found in SagaStore", $sagaName, $sagaId));
+    }
+}

src/EventStore/Saga/RdbmsSagaStoreRepository.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Gember\DependencyContracts\EventStore\Saga;
+
+use Stringable;
+use DateTimeImmutable;
+
+interface RdbmsSagaStoreRepository
+{
+    /**
+     * @throws RdbmsSagaNotFoundException
+     */
+    public function get(string $sagaName, string|Stringable $sagaId): RdbmsSaga;
+
+    /**
+     * @param array<string, mixed> $metadata
+     */
+    public function save(
+        string $sagaName,
+        string|Stringable $sagaId,
+        string $payload,
+        array $metadata,
+        DateTimeImmutable $now,
+    ): RdbmsSaga;
+}