Add resolve distribution strategy field to Package entity

Author: codedmonkey

migrations/Version20260616143154.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version20260616143154 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Add package distribution strategy';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->addSql(<<<'SQL'
+            ALTER TABLE package ADD resolve_distribution_strategy VARCHAR(255) DEFAULT NULL
+        SQL);
+        $this->addSql(<<<'SQL'
+            UPDATE package SET resolve_distribution_strategy = 'dynamic'
+        SQL);
+        $this->addSql(<<<'SQL'
+            ALTER TABLE package ALTER resolve_distribution_strategy TYPE VARCHAR(255)
+        SQL);
+        $this->addSql(<<<'SQL'
+            ALTER TABLE package ALTER resolve_distribution_strategy SET NOT NULL
+        SQL);
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql(<<<'SQL'
+            ALTER TABLE package DROP resolve_distribution_strategy
+        SQL);
+    }
+}

src/Doctrine/Entity/Package.php

@@ -6,6 +6,7 @@
 
 use CodedMonkey\Dirigent\Doctrine\Repository\PackageRepository;
 use CodedMonkey\Dirigent\Entity\PackageFetchStrategy;
+use CodedMonkey\Dirigent\Entity\ResolveDistributionStrategy;
 use CodedMonkey\Dirigent\Package\PackageMetadataResolver;
 use CodedMonkey\Dirigent\Validator\UniquePackage;
 use Composer\Package\Version\VersionParser;
@@ -68,6 +69,9 @@ class Package extends TrackedEntity
     #[ORM\Column(nullable: true, enumType: PackageFetchStrategy::class)]
     private ?PackageFetchStrategy $fetchStrategy = null;
 
+    #[ORM\Column(enumType: ResolveDistributionStrategy::class)]
+    private ResolveDistributionStrategy $resolveDistributionStrategy = ResolveDistributionStrategy::Dynamic;
+
     #[ORM\ManyToOne]
     private ?Registry $mirrorRegistry = null;
 
@@ -248,6 +252,16 @@ public function setFetchStrategy(PackageFetchStrategy $fetchStrategy): void
         $this->fetchStrategy = $fetchStrategy;
     }
 
+    public function getResolveDistributionStrategy(): ResolveDistributionStrategy
+    {
+        return $this->resolveDistributionStrategy;
+    }
+
+    public function setResolveDistributionStrategy(ResolveDistributionStrategy $resolveDistributionStrategy): void
+    {
+        $this->resolveDistributionStrategy = $resolveDistributionStrategy;
+    }
+
     public function getMirrorRegistry(): ?Registry
     {
         return $this->mirrorRegistry;

src/Entity/ResolveDistributionStrategy.php

@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+namespace CodedMonkey\Dirigent\Entity;
+
+use Symfony\Contracts\Translation\TranslatableInterface;
+use Symfony\Contracts\Translation\TranslatorInterface;
+
+enum ResolveDistributionStrategy: string implements TranslatableInterface
+{
+    case Disabled = 'none';
+    case Dynamic = 'dynamic';
+    case Automatic = 'auto';
+
+    public function isDisabled(): bool
+    {
+        return self::Disabled === $this;
+    }
+
+    public function isDynamic(): bool
+    {
+        return self::Dynamic === $this;
+    }
+
+    public function isAutomatic(): bool
+    {
+        return self::Automatic === $this;
+    }
+
+    /**
+     * Whether the strategy allows dynamic updates.
+     *
+     * Only the disabled strategy doesn't allow this.
+     */
+    public function allowDynamic(): bool
+    {
+        return !$this->isDisabled();
+    }
+
+    public function trans(TranslatorInterface $translator, ?string $locale = null): string
+    {
+        return $translator->trans("package.resolve-distribution-strategy.$this->value");
+    }
+}

src/Form/PackageFormType.php

@@ -9,8 +9,10 @@
 use CodedMonkey\Dirigent\Doctrine\Entity\Registry;
 use CodedMonkey\Dirigent\Doctrine\Repository\RegistryRepository;
 use CodedMonkey\Dirigent\Entity\PackageFetchStrategy;
+use CodedMonkey\Dirigent\Entity\ResolveDistributionStrategy;
 use CodedMonkey\Dirigent\Package\PackageVcsRepositoryValidator;
 use Symfony\Bridge\Doctrine\Form\Type\EntityType;
+use Symfony\Component\DependencyInjection\Attribute\Autowire;
 use Symfony\Component\Form\AbstractType;
 use Symfony\Component\Form\Event\PostSetDataEvent;
 use Symfony\Component\Form\Event\SubmitEvent;
@@ -25,6 +27,8 @@ class PackageFormType extends AbstractType
 {
     public function __construct(
         private readonly PackageVcsRepositoryValidator $vcsRepositoryValidator,
+        #[Autowire(param: 'dirigent.distributions.enabled')]
+        private readonly bool $distributionsEnabled,
     ) {
     }
 
@@ -48,6 +52,14 @@ public function buildForm(FormBuilderInterface $builder, array $options): void
             ])
             ->addEventListener(FormEvents::POST_SET_DATA, $this->onPostSetData(...))
             ->addEventListener(FormEvents::SUBMIT, $this->onSubmit(...));
+
+        if ($this->distributionsEnabled) {
+            $builder->add('resolveDistributionStrategy', EnumType::class, [
+                'label' => 'Resolve distributions',
+                'class' => ResolveDistributionStrategy::class,
+                'expanded' => true,
+            ]);
+        }
     }
 
     public function onPostSetData(PostSetDataEvent $event): void

translations/messages.en.yaml

@@ -118,6 +118,10 @@ package:
   fetch-strategy:
     mirror: Fetch from registry
     vcs: Fetch from VCS
+  resolve-distribution-strategy:
+    auto: Resolve all distributions
+    dynamic: Resolve distributions on request
+    none: Never resolve distributions
 registry:
   package-mirroring:
     none: Package mirroring disabled