Distributions and tracked entities?

Author: codedmonkey

migrations/Version20250610105944.php

@@ -17,7 +17,7 @@ public function getDescription(): string
     public function up(Schema $schema): void
     {
         $this->addSql(<<<'SQL'
-            CREATE TABLE distribution (id INT GENERATED BY DEFAULT AS IDENTITY NOT NULL, reference VARCHAR(255) NOT NULL, version_id INT NOT NULL, PRIMARY KEY(id))
+            CREATE TABLE distribution (id INT GENERATED BY DEFAULT AS IDENTITY NOT NULL, reference VARCHAR(255) NOT NULL, type VARCHAR(255) NOT NULL, source VARCHAR(255) NOT NULL, version_id INT NOT NULL, PRIMARY KEY(id))
         SQL);
         $this->addSql(<<<'SQL'
             CREATE INDEX IDX_A44837814BBC2705 ON distribution (version_id)

src/Controller/ApiController.php

@@ -81,7 +81,9 @@ public function packageMetadata(string $packageName): Response
             throw $this->createNotFoundException();
         }
 
-        $this->messenger->dispatch(new UpdatePackage($package->getId()));
+        if ($this->getParameter('dirigent.packages.dynamic_updates')) {
+            $this->messenger->dispatch(new UpdatePackage($package->getId()));
+        }
 
         if (!$this->providerManager->exists($packageName)) {
             throw $this->createNotFoundException();

src/Doctrine/Entity/Distribution.php

@@ -3,21 +3,30 @@
 namespace CodedMonkey\Dirigent\Doctrine\Entity;
 
 use CodedMonkey\Dirigent\Doctrine\Repository\DistributionRepository;
+use Doctrine\DBAL\Types\Types;
 use Doctrine\ORM\Mapping as ORM;
 
 #[ORM\Entity(repositoryClass: DistributionRepository::class)]
-class Distribution
+class Distribution extends TrackedEntity
 {
     #[ORM\Column, ORM\GeneratedValue, ORM\Id]
     private ?int $id = null;
 
-    #[ORM\ManyToOne]
+    #[ORM\ManyToOne(inversedBy: 'distributions')]
     #[ORM\JoinColumn(nullable: false)]
     private ?Version $version = null;
 
     #[ORM\Column]
     private ?string $reference = null;
 
+    #[ORM\Column]
+    private ?string $type = null;
+
+    private \DateTimeImmutable $releasedAt;
+
+    #[ORM\Column(type: Types::TEXT, nullable: true)]
+    private ?string $source = null;
+
     public function getId(): ?int
     {
         return $this->id;
@@ -33,7 +42,7 @@ public function setVersion(Version $version): void
         $this->version = $version;
     }
 
-    public function getReference(): ?string
+    public function getReference(): string
     {
         return $this->reference;
     }
@@ -42,4 +51,34 @@ public function setReference(string $reference): void
     {
         $this->reference = $reference;
     }
+
+    public function getType(): string
+    {
+        return $this->type;
+    }
+
+    public function setType(string $type): void
+    {
+        $this->type = $type;
+    }
+
+    public function getReleasedAt(): \DateTimeImmutable
+    {
+        return $this->releasedAt;
+    }
+
+    public function setReleasedAt(\DateTimeImmutable $releasedAt): void
+    {
+        $this->releasedAt = $releasedAt;
+    }
+
+    public function getSource(): string
+    {
+        return $this->source;
+    }
+
+    public function setSource(string $source): void
+    {
+        $this->source = $source;
+    }
 }

src/Doctrine/Entity/TrackedEntity.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace CodedMonkey\Dirigent\Doctrine\Entity;
+
+use Doctrine\DBAL\Types\Types;
+use Doctrine\ORM\Mapping as ORM;
+
+#[ORM\MappedSuperclass]
+abstract class TrackedEntity
+{
+    #[ORM\Column(type: Types::DATETIME_IMMUTABLE)]
+    protected readonly \DateTimeImmutable $createdAt;
+
+    #[ORM\Column(type: Types::DATETIME_IMMUTABLE)]
+    protected ?\DateTimeImmutable $modifiedAt = null;
+
+    public function getCreatedAt(): \DateTimeImmutable
+    {
+        return $this->createdAt;
+    }
+
+    #[ORM\PrePersist]
+    public function setCreatedAt(): void
+    {
+        $this->createdAt ??= new \DateTimeImmutable();
+    }
+
+    public function getModifiedAt(): ?\DateTimeImmutable
+    {
+        return $this->modifiedAt;
+    }
+
+    #[ORM\PreUpdate]
+    public function setModifiedAt(): void
+    {
+        $this->modifiedAt = new \DateTimeImmutable();
+    }
+}

src/Doctrine/Entity/Version.php

@@ -114,6 +114,9 @@ class Version
     #[ORM\ManyToOne(targetEntity: Package::class, inversedBy: 'versions')]
     private ?Package $package = null;
 
+    #[ORM\OneToMany(targetEntity: Distribution::class, mappedBy: 'version')]
+    private Collection $distributions;
+
     #[ORM\OneToOne(mappedBy: 'version', cascade: ['persist', 'detach', 'remove'])]
     private VersionInstallations $installations;
 
@@ -135,6 +138,7 @@ public function __construct()
         $this->replace = new ArrayCollection();
         $this->suggest = new ArrayCollection();
         $this->tags = new ArrayCollection();
+        $this->distributions = new ArrayCollection();
         $this->installations = new VersionInstallations($this);
         $this->createdAt = new \DateTime();
     }
@@ -484,6 +488,14 @@ public function setPackage(Package $package): void
         $this->package = $package;
     }
 
+    /**
+     * @return Collection<int, Distribution>
+     */
+    public function getDistributions(): Collection
+    {
+        return $this->distributions;
+    }
+
     public function getInstallations(): VersionInstallations
     {
         return $this->installations;

src/Package/PackageDistributionResolver.php

@@ -42,11 +42,28 @@ public function __construct(
         $this->distributionStoragePath = "$storagePath/distribution";
     }
 
+    public function isAvailable(): bool
+    {
+
+    }
+
+    /**
+     * Check if the distribution exists on the filesystem, circumventing the database.
+     */
     public function exists(string $packageName, string $packageVersion, ?string $reference, ?string $type): bool
     {
         return null !== $reference && null !== $type && $this->filesystem->exists($this->path($packageName, $packageVersion, $reference, $type));
     }
 
+    public function findEntity(Version $version, string $reference, string $type): ?Distribution
+    {
+        return $this->distributionRepository->findOneBy([
+            'version' => $version,
+            'reference' => $reference,
+            'type' => $type,
+        ]);
+    }
+
     public function path(string $packageName, string $packageVersion, string $reference, string $type): string
     {
         return "$this->distributionStoragePath/$packageName/$packageVersion-$reference.$type";
@@ -120,6 +137,7 @@ private function build(Version $version, ?string $reference, ?string $type): boo
         $distribution = new Distribution();
         $distribution->setVersion($version);
         $distribution->setReference($reference);
+        $distribution->setType($type);
 
         $this->distributionRepository->save($distribution, true);
 
@@ -150,6 +168,9 @@ private function mirror(Version $version, ?string $reference, ?string $type): bo
         $distribution = new Distribution();
         $distribution->setVersion($version);
         $distribution->setReference($reference);
+        $distribution->setType($type);
+        $distribution->setReleasedAt($version->getReleasedAt());
+        $distribution->setSource($distributionUrl);
 
         $this->distributionRepository->save($distribution, true);
 

templates/dashboard/packages/package_versions.html.twig

@@ -16,7 +16,10 @@
               / {{ version.versionAlias }}
             {% endif %}
           </span>
-          <span class="text-muted">{{ version.releasedAt|date }}</span>
+          <span class="text-muted">
+            {% dump version.distributions.toArray() %}
+            {{ version.releasedAt|date }}
+          </span>
         </div>
       </a>
     {% endfor %}