fix: normalize tenant to string to match database round-trip type

setTenant() accepts int|string|null but PDO returns tenant as a string
after storage. The strict !== comparisons in getCollection() then fail
because (int)1 !== "1", causing "Collection not found" errors. The
Sequence validator also rejects integer tenant values since $tenant
has type VAR_ID which requires strings.

Cast tenant to string in Adapter::setTenant(), Document::getTenant(),
and the tenantPerDocument document paths. Skip Sequence validation for
$tenant since it's a user-provided identifier, not a sequence-generated
ID.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: loks0n

src/Database/Adapter.php

@@ -23,7 +23,7 @@ abstract class Adapter
 
     protected bool $sharedTables = false;
 
-    protected int|string|null $tenant = null;
+    protected string|null $tenant = null;
 
     protected bool $tenantPerDocument = false;
 
@@ -225,7 +225,7 @@ public function getSharedTables(): bool
      */
     public function setTenant(int|string|null $tenant): bool
     {
-        $this->tenant = $tenant;
+        $this->tenant = $tenant !== null ? (string) $tenant : null;
 
         return true;
     }
@@ -235,9 +235,9 @@ public function setTenant(int|string|null $tenant): bool
      *
      * Get tenant to use for shared tables
      *
-     * @return int|string|null
+     * @return string|null
      */
-    public function getTenant(): int|string|null
+    public function getTenant(): string|null
     {
         return $this->tenant;
     }

src/Database/Database.php

@@ -1250,9 +1250,9 @@ public function setTenant(int|string|null $tenant): static
      *
      * Get tenant to use if tables are shared
      *
-     * @return int|string|null
+     * @return string|null
      */
-    public function getTenant(): int|string|null
+    public function getTenant(): string|null
     {
         return $this->adapter->getTenant();
     }
@@ -5503,12 +5503,16 @@ public function createDocument(string $collection, Document $document): Document
 
         if ($this->adapter->getSharedTables()) {
             if ($this->adapter->getTenantPerDocument()) {
+                $tenant = $document->getTenant();
                 if (
                     $collection->getId() !== static::METADATA
-                    && $document->getTenant() === null
+                    && $tenant === null
                 ) {
                     throw new DatabaseException('Missing tenant. Tenant must be set when tenant per document is enabled.');
                 }
+                if ($tenant !== null) {
+                    $document->setAttribute('$tenant', (string) $tenant);
+                }
             } else {
                 $document->setAttribute('$tenant', $this->adapter->getTenant());
             }
@@ -5621,9 +5625,11 @@ public function createDocuments(
 
             if ($this->adapter->getSharedTables()) {
                 if ($this->adapter->getTenantPerDocument()) {
-                    if ($document->getTenant() === null) {
+                    $tenant = $document->getTenant();
+                    if ($tenant === null) {
                         throw new DatabaseException('Missing tenant. Tenant must be set when tenant per document is enabled.');
                     }
+                    $document->setAttribute('$tenant', (string) $tenant);
                 } else {
                     $document->setAttribute('$tenant', $this->adapter->getTenant());
                 }
@@ -7198,9 +7204,11 @@ public function upsertDocumentsWithIncrease(
 
             if ($this->adapter->getSharedTables()) {
                 if ($this->adapter->getTenantPerDocument()) {
-                    if ($document->getTenant() === null) {
+                    $tenant = $document->getTenant();
+                    if ($tenant === null) {
                         throw new DatabaseException('Missing tenant. Tenant must be set when tenant per document is enabled.');
                     }
+                    $document->setAttribute('$tenant', (string) $tenant);
                     if (!$old->isEmpty() && $old->getTenant() !== $document->getTenant()) {
                         throw new DatabaseException('Tenant cannot be changed.');
                     }

src/Database/Document.php

@@ -175,9 +175,11 @@ public function getUpdatedAt(): ?string
     /**
      * @return int|string|null
      */
-    public function getTenant(): int|string|null
+    public function getTenant(): string|null
     {
-        return $this->getAttribute('$tenant');
+        $tenant = $this->getAttribute('$tenant');
+
+        return $tenant !== null ? (string) $tenant : null;
     }
 
     /**

src/Database/Validator/Structure.php

@@ -340,6 +340,9 @@ protected function checkForInvalidAttributeValues(array $structure, array $keys)
 
             switch ($type) {
                 case Database::VAR_ID:
+                    if ($key === '$tenant') {
+                        break;
+                    }
                     $validators[] = new Sequence($this->idAttributeType, $attribute['$id'] === '$sequence');
                     break;