feat(adapter): add support for upsert on unique index across database…

src/Database/Adapter.php

@@ -1089,6 +1089,13 @@ abstract public function getSupportForGetConnectionId(): bool;
      */
     abstract public function getSupportForUpserts(): bool;
 
+    /**
+     * Is upsert via arbitrary unique indexes supported?
+     *
+     * @return bool
+     */
+    abstract public function getSupportForUpsertOnUniqueIndex(): bool;
+
     /**
      * Is vector type supported?
      *

src/Database/Adapter/MariaDB.php

@@ -1840,6 +1840,11 @@ public function getSupportForUpserts(): bool
         return true;
     }
 
+    public function getSupportForUpsertOnUniqueIndex(): bool
+    {
+        return true;
+    }
+
     public function getSupportForSchemaAttributes(): bool
     {
         return true;

src/Database/Adapter/Memory.php

@@ -1924,6 +1924,11 @@ public function getSupportForUpserts(): bool
         return false;
     }
 
+    public function getSupportForUpsertOnUniqueIndex(): bool
+    {
+        return false;
+    }
+
     public function getSupportForVectors(): bool
     {
         return false;

src/Database/Adapter/Mongo.php

@@ -3299,6 +3299,11 @@ public function getSupportForUpserts(): bool
         return true;
     }
 
+    public function getSupportForUpsertOnUniqueIndex(): bool
+    {
+        return false;
+    }
+
     public function getSupportForReconnection(): bool
     {
         return false;

src/Database/Adapter/Pool.php

@@ -493,6 +493,11 @@ public function getSupportForUpserts(): bool
         return $this->delegate(__FUNCTION__, \func_get_args());
     }
 
+    public function getSupportForUpsertOnUniqueIndex(): bool
+    {
+        return $this->delegate(__FUNCTION__, \func_get_args());
+    }
+
     public function getSupportForVectors(): bool
     {
         return $this->delegate(__FUNCTION__, \func_get_args());

src/Database/Adapter/Postgres.php

@@ -2156,6 +2156,11 @@ public function getSupportForUpserts(): bool
         return true;
     }
 
+    public function getSupportForUpsertOnUniqueIndex(): bool
+    {
+        return false;
+    }
+
     /**
      * Is vector type supported?
      *

src/Database/Adapter/SQLite.php

@@ -989,6 +989,11 @@ public function getSupportForUpserts(): bool
         return false;
     }
 
+    public function getSupportForUpsertOnUniqueIndex(): bool
+    {
+        return false;
+    }
+
     /**
      * Is hostname supported?
      *