feat(core): add tenant system store contracts and configuration

Signed-off-by: Sebastian Krupinski <krupinski01@gmail.com>

tests/php/Unit/SystemStore/SystemStoreContractsTest.php

@@ -6,12 +6,15 @@ namespace KTXT\Unit\SystemStore;
 
 use DateTimeImmutable;
 use InvalidArgumentException;
+use KTXC\Models\Tenant\TenantConfiguration;
 use KTXF\Resource\Provider\ProviderInterface;
 use KTXF\Resource\Provider\ResourceProviderBaseInterface;
 use KTXF\Resource\Provider\ResourceServiceBaseInterface;
 use KTXF\SystemStore\BlobInfo;
 use KTXF\SystemStore\Provider\ProviderBaseInterface;
 use KTXF\SystemStore\Service\SystemStoreServiceInterface;
+use KTXF\SystemStore\StoreReference;
+use KTXF\SystemStore\SystemStoreManagerInterface;
 use KTXF\SystemStore\WriteCondition;
 use PHPUnit\Framework\Attributes\Test;
 use PHPUnit\Framework\TestCase;
@@ -41,6 +44,17 @@ final class SystemStoreContractsTest extends TestCase
         self::assertCount(1, $method->getParameters());
     }
 
+    #[Test]
+    public function managerContractExposesTenantScopedStoreOperations(): void
+    {
+        $manager = new ReflectionClass(SystemStoreManagerInterface::class);
+
+        self::assertSame(
+            ['stat', 'read', 'write', 'delete', 'list'],
+            array_map(static fn($method): string => $method->getName(), $manager->getMethods()),
+        );
+    }
+
     #[Test]
     public function createsSupportedWriteConditions(): void
     {
@@ -60,7 +74,7 @@ final class SystemStoreContractsTest extends TestCase
     }
 
     #[Test]
-    public function serializesMetadata(): void
+    public function exposesBlobInformation(): void
     {
         $metadata = new BlobInfo(
             key: 'previews/example.webp',
@@ -71,13 +85,46 @@ final class SystemStoreContractsTest extends TestCase
             attributes: ['variant' => 'popover'],
         );
 
-        self::assertSame([
-            'key' => 'previews/example.webp',
-            'mime' => 'image/webp',
-            'size' => 123,
-            'etag' => 'revision-1',
-            'modifiedAt' => '2026-08-28T12:00:00+00:00',
-            'attributes' => ['variant' => 'popover'],
-        ], $metadata->jsonSerialize());
+        self::assertSame('previews/example.webp', $metadata->key);
+        self::assertSame('image/webp', $metadata->mimeType);
+        self::assertSame(123, $metadata->size);
+        self::assertSame('revision-1', $metadata->etag);
+        self::assertSame(['variant' => 'popover'], $metadata->attributes);
+        self::assertNotInstanceOf(\JsonSerializable::class, $metadata);
+    }
+
+    #[Test]
+    public function parsesLogicalStoresFromTenantConfiguration(): void
+    {
+        $data = [
+            'stores' => [
+                'previews' => [
+                    'provider' => 's3',
+                    'service' => 'preview-storage',
+                    'namespace' => 'previews',
+                ],
+            ],
+        ];
+
+        $configuration = (new TenantConfiguration())->jsonDeserialize($data);
+
+        self::assertInstanceOf(StoreReference::class, $configuration->stores()->store('previews'));
+        self::assertSame('s3', $configuration->stores()->store('previews')?->provider);
+        self::assertSame($data['stores'], $configuration->jsonSerialize()['stores']);
+    }
+
+    #[Test]
+    public function rejectsInvalidLogicalStoreNames(): void
+    {
+        $this->expectException(InvalidArgumentException::class);
+        (new TenantConfiguration())->jsonDeserialize([
+            'stores' => [
+                '../previews' => [
+                    'provider' => 's3',
+                    'service' => 'preview-storage',
+                    'namespace' => 'previews',
+                ],
+            ],
+        ]);
     }
 }