Add backup policy migration support

composer.json

@@ -25,7 +25,7 @@
         "php": ">=8.1",
         "ext-curl": "*",
         "ext-openssl": "*",
-        "appwrite/appwrite": "19.*",
+        "appwrite/appwrite": "20.*",
         "utopia-php/database": "5.*",
         "utopia-php/storage": "1.0.*",
         "utopia-php/dsn": "0.2.*",

src/Migration/Destinations/Appwrite.php

@@ -11,6 +11,7 @@
 use Appwrite\Enums\PasswordHash;
 use Appwrite\Enums\Runtime;
 use Appwrite\InputFile;
+use Appwrite\Services\Backups;
 use Appwrite\Services\Functions;
 use Appwrite\Services\Sites;
 use Appwrite\Services\Storage;
@@ -38,6 +39,7 @@
 use Utopia\Migration\Resources\Auth\Membership;
 use Utopia\Migration\Resources\Auth\Team;
 use Utopia\Migration\Resources\Auth\User;
+use Utopia\Migration\Resources\Backups\Policy;
 use Utopia\Migration\Resources\Database\Column;
 use Utopia\Migration\Resources\Database\Database;
 use Utopia\Migration\Resources\Database\Index;
@@ -60,6 +62,7 @@ class Appwrite extends Destination
 
     protected string $key;
 
+    private Backups $backups;
     private Functions $functions;
     private Sites $sites;
     private Storage $storage;
@@ -94,6 +97,7 @@ public function __construct(
             ->setProject($project)
             ->setKey($key);
 
+        $this->backups = new Backups($this->client);
         $this->functions = new Functions($this->client);
         $this->sites = new Sites($this->client);
         $this->storage = new Storage($this->client);
@@ -138,6 +142,9 @@ public static function getSupportedResources(): array
             Resource::TYPE_DEPLOYMENT,
             Resource::TYPE_ENVIRONMENT_VARIABLE,
 
+            // Backups
+            Resource::TYPE_BACKUP_POLICY,
+
             // Sites
             Resource::TYPE_SITE,
             Resource::TYPE_SITE_DEPLOYMENT,
@@ -222,6 +229,15 @@ public function report(array $resources = [], array $resourceIds = []): array
                 $this->sites->create('', '', Framework::OTHER(), BuildRuntime::STATIC1());
             }
 
+            // Backups
+            if (\in_array(Resource::TYPE_BACKUP_POLICY, $resources)) {
+                $scope = 'policies.read';
+                $this->backups->listPolicies();
+
+                $scope = 'policies.write';
+                $this->backups->createPolicy('', [], 0, '');
+            }
+
         } catch (AppwriteException $e) {
             if ($e->getCode() === 403) {
                 throw new \Exception('Missing scope: ' . $scope, previous: $e);
@@ -259,6 +275,7 @@ protected function import(array $resources, callable $callback): void
                     Transfer::GROUP_STORAGE => $this->importFileResource($resource),
                     Transfer::GROUP_AUTH => $this->importAuthResource($resource),
                     Transfer::GROUP_FUNCTIONS => $this->importFunctionResource($resource),
+                    Transfer::GROUP_BACKUPS => $this->importBackupResource($resource),
                     Transfer::GROUP_SITES => $this->importSiteResource($resource),
                     default => throw new \Exception('Invalid resource group'),
                 };
@@ -1406,9 +1423,6 @@ public function importFunctionResource(Resource $resource): Resource
                     'dart-2.17' => Runtime::DART217(),
                     'dart-2.18' => Runtime::DART218(),
                     'dart-2.19' => Runtime::DART219(),
-                    'deno-1.21' => Runtime::DENO121(),
-                    'deno-1.24' => Runtime::DENO124(),
-                    'deno-1.35' => Runtime::DENO135(),
                     'deno-1.40' => Runtime::DENO140(),
                     'deno-1.46' => Runtime::DENO146(),
                     'deno-2.0' => Runtime::DENO20(),
@@ -1467,6 +1481,31 @@ public function importFunctionResource(Resource $resource): Resource
         return $resource;
     }
 
+    /**
+     * @throws \Exception
+     */
+    public function importBackupResource(Resource $resource): Resource
+    {
+        switch ($resource->getName()) {
+            case Resource::TYPE_BACKUP_POLICY:
+                /** @var Policy $resource */
+                $this->backups->createPolicy(
+                    policyId: $resource->getId(),
+                    services: $resource->getServices(),
+                    retention: $resource->getRetention(),
+                    schedule: $resource->getSchedule(),
+                    name: $resource->getPolicyName() ?: null,
+                    resourceId: $resource->getResourceId() ?: null,
+                    enabled: $resource->getEnabled(),
+                );
+                break;
+        }
+
+        $resource->setStatus(Resource::STATUS_SUCCESS);
+
+        return $resource;
+    }
+
     /**
      * @throws AppwriteException
      * @throws \Exception
@@ -1573,9 +1612,6 @@ public function importSiteResource(Resource $resource): Resource
                     'dart-2.17' => BuildRuntime::DART217(),
                     'dart-2.18' => BuildRuntime::DART218(),
                     'dart-2.19' => BuildRuntime::DART219(),
-                    'deno-1.21' => BuildRuntime::DENO121(),
-                    'deno-1.24' => BuildRuntime::DENO124(),
-                    'deno-1.35' => BuildRuntime::DENO135(),
                     'deno-1.40' => BuildRuntime::DENO140(),
                     'deno-1.46' => BuildRuntime::DENO146(),
                     'deno-2.0' => BuildRuntime::DENO20(),

src/Migration/Resource.php

@@ -60,6 +60,9 @@ abstract class Resource implements \JsonSerializable
 
     public const TYPE_ENVIRONMENT_VARIABLE = 'environment-variable';
 
+    // Backups
+    public const TYPE_BACKUP_POLICY = 'backup-policy';
+
     // legacy terminologies
     public const TYPE_DOCUMENT = 'document';
     public const TYPE_ATTRIBUTE = 'attribute';
@@ -89,6 +92,7 @@ abstract class Resource implements \JsonSerializable
         self::TYPE_ENVIRONMENT_VARIABLE,
         self::TYPE_TEAM,
         self::TYPE_MEMBERSHIP,
+        self::TYPE_BACKUP_POLICY,
 
         // legacy
         self::TYPE_DOCUMENT,

src/Migration/Resources/Backups/Policy.php

@@ -0,0 +1,115 @@
+<?php
+
+namespace Utopia\Migration\Resources\Backups;
+
+use Utopia\Migration\Resource;
+use Utopia\Migration\Transfer;
+
+class Policy extends Resource
+{
+    /**
+     * @param string $id
+     * @param string $name
+     * @param array<string> $services
+     * @param int $retention
+     * @param string $schedule
+     * @param bool $enabled
+     * @param string $resourceId
+     * @param string $resourceType
+     */
+    public function __construct(
+        string $id = '',
+        private readonly string $name = '',
+        private readonly array $services = [],
+        private readonly int $retention = 0,
+        private readonly string $schedule = '',
+        private readonly bool $enabled = true,
+        private readonly string $resourceId = '',
+        private readonly string $resourceType = '',
+    ) {
+        $this->id = $id;
+    }
+
+    /**
+     * @param array<string, mixed> $array
+     * @return self
+     */
+    public static function fromArray(array $array): self
+    {
+        return new self(
+            $array['id'],
+            $array['name'] ?? '',
+            $array['services'] ?? [],
+            $array['retention'] ?? 0,
+            $array['schedule'] ?? '',
+            $array['enabled'] ?? true,
+            $array['resourceId'] ?? '',
+            $array['resourceType'] ?? '',
+        );
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function jsonSerialize(): array
+    {
+        return [
+            'id' => $this->id,
+            'name' => $this->name,
+            'services' => $this->services,
+            'retention' => $this->retention,
+            'schedule' => $this->schedule,
+            'enabled' => $this->enabled,
+            'resourceId' => $this->resourceId,
+            'resourceType' => $this->resourceType,
+        ];
+    }
+
+    public static function getName(): string
+    {
+        return Resource::TYPE_BACKUP_POLICY;
+    }
+
+    public function getGroup(): string
+    {
+        return Transfer::GROUP_BACKUPS;
+    }
+
+    public function getPolicyName(): string
+    {
+        return $this->name;
+    }
+
+    /**
+     * @return array<string>
+     */
+    public function getServices(): array
+    {
+        return $this->services;
+    }
+
+    public function getRetention(): int
+    {
+        return $this->retention;
+    }
+
+    public function getSchedule(): string
+    {
+        return $this->schedule;
+    }
+
+    public function getEnabled(): bool
+    {
+        return $this->enabled;
+    }
+
+    public function getResourceId(): string
+    {
+        return $this->resourceId;
+    }
+
+    public function getResourceType(): string
+    {
+        return $this->resourceType;
+    }
+}

src/Migration/Source.php

@@ -36,6 +36,11 @@ public function getFunctionsBatchSize(): int
         return static::$defaultBatchSize;
     }
 
+    public function getBackupsBatchSize(): int
+    {
+        return static::$defaultBatchSize;
+    }
+
     public function getSitesBatchSize(): int
     {
         return static::$defaultBatchSize;
@@ -94,6 +99,7 @@ public function exportResources(array $resources): void
                 Transfer::GROUP_DATABASES => Transfer::GROUP_DATABASES_RESOURCES,
                 Transfer::GROUP_STORAGE => Transfer::GROUP_STORAGE_RESOURCES,
                 Transfer::GROUP_FUNCTIONS => Transfer::GROUP_FUNCTIONS_RESOURCES,
+                Transfer::GROUP_BACKUPS => Transfer::GROUP_BACKUPS_RESOURCES,
                 Transfer::GROUP_SITES => Transfer::GROUP_SITES_RESOURCES,
             ];
 
@@ -123,6 +129,9 @@ public function exportResources(array $resources): void
                 case Transfer::GROUP_FUNCTIONS:
                     $this->exportGroupFunctions($this->getFunctionsBatchSize(), $resources);
                     break;
+                case Transfer::GROUP_BACKUPS:
+                    $this->exportGroupBackups($this->getBackupsBatchSize(), $resources);
+                    break;
                 case Transfer::GROUP_SITES:
                     $this->exportGroupSites($this->getSitesBatchSize(), $resources);
                     break;
@@ -162,6 +171,14 @@ abstract protected function exportGroupStorage(int $batchSize, array $resources)
      */
     abstract protected function exportGroupFunctions(int $batchSize, array $resources): void;
 
+    /**
+     * Export Backups Group
+     *
+     * @param int $batchSize
+     * @param array<string> $resources Resources to export
+     */
+    abstract protected function exportGroupBackups(int $batchSize, array $resources): void;
+
     /**
      * Export Sites Group
      *