Add LAST-MODIFIED property

CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+-   Event LAST-MODIFIED property [#298](https://github.com/markuspoerschke/iCal/pull/298)
+
 ## [2.2.0] - 2021-05-03
 
 ### Added

src/Domain/Entity/Event.php

@@ -28,6 +28,7 @@ class Event
     private ?Occurrence $occurrence = null;
     private ?Location $location = null;
     private ?Organizer $organizer = null;
+    private ?Timestamp $lastModified = null;
 
     /**
      * @var array<Alarm>
@@ -200,4 +201,23 @@ public function getAttachments(): array
     {
         return $this->attachments;
     }
+
+    public function getLastModified(): Timestamp
+    {
+        assert($this->lastModified !== null);
+
+        return $this->lastModified;
+    }
+
+    public function hasLastModified(): bool
+    {
+        return $this->lastModified !== null;
+    }
+
+    public function setLastModified(?Timestamp $lastModified): self
+    {
+        $this->lastModified = $lastModified;
+
+        return $this;
+    }
 }

src/Presentation/Factory/EventFactory.php

@@ -76,6 +76,10 @@ protected function getProperties(Event $event): Generator
         yield new Property('UID', new TextValue((string) $event->getUniqueIdentifier()));
         yield new Property('DTSTAMP', new DateTimeValue($event->getTouchedAt()));
 
+        if ($event->hasLastModified()) {
+            yield new Property('LAST-MODIFIED', new DateTimeValue($event->getLastModified()));
+        }
+
         if ($event->hasSummary()) {
             yield new Property('SUMMARY', new TextValue($event->getSummary()));
         }

tests/Unit/Presentation/Factory/EventFactoryTest.php

@@ -44,12 +44,24 @@ public function testMinimalEvent()
             )
         );
 
-        $event = (new Event(new UniqueIdentifier('event1')))->touch($currentTime);
+        $lastModified = new Timestamp(
+            DateTimeImmutable::createFromFormat(
+                'Y-m-d H:i:s',
+                '2019-10-09 10:11:22',
+                new DateTimeZone('UTC')
+            )
+        );
+
+        $event = (new Event(new UniqueIdentifier('event1')))
+            ->touch($currentTime)
+            ->setLastModified($lastModified)
+        ;
 
         $expected = implode(ContentLine::LINE_SEPARATOR, [
             'BEGIN:VEVENT',
             'UID:event1',
             'DTSTAMP:20191110T112233Z',
+            'LAST-MODIFIED:20191009T101122Z',
             'END:VEVENT',
             '',
         ]);

website/docs/maturity-matrix.md

@@ -42,7 +42,7 @@ See [RFC 5545 section 3.6.1](https://tools.ietf.org/html/rfc5545#section-3.6.1).
 | created                     |     ✖     |
 | description                 |     ✔     |
 | geo                         |     ✔     |
-| last-mod                    |     ✖     |
+| last-mod                    |     ✔     |
 | location                    |     ✔     |
 | organizer                   |     ✔     |
 | priority                    |     ✖     |