Merge pull request #95 from mogic-le/cal-source

Add calendar source parameter

Author: freekmurze

src/Components/Calendar.php

@@ -34,6 +34,8 @@ class Calendar extends Component implements HasTimezones
 
     private ?string $productIdentifier = null;
 
+    private ?string $source = null;
+
     public static function create(string $name = null): Calendar
     {
         return new self($name);
@@ -146,6 +148,18 @@ public function refreshInterval(int $minutes): Calendar
         return $this;
     }
 
+    /**
+     * Identifies a location where a client can retrieve updated data for the calendar.
+     *
+     * @link https://datatracker.ietf.org/doc/html/rfc7986#section-5.7
+     */
+    public function source(string $source): self
+    {
+        $this->source = $source;
+
+        return $this;
+    }
+
     public function get(): string
     {
         return $this->toString();
@@ -173,6 +187,10 @@ protected function payload(): ComponentPayload
                 $this->description,
                 fn () => TextProperty::create('DESCRIPTION', $this->description)->addAlias('X-WR-CALDESC')
             )
+            ->optional(
+                $this->source,
+                fn () => TextProperty::create('SOURCE', $this->source)->addParameter(new Parameter('VALUE', 'URI'))
+            )
             ->optional(
                 $this->refreshInterval,
                 fn () => DurationProperty::create('REFRESH-INTERVAL', $this->refreshInterval)->addParameter(new Parameter('VALUE', 'DURATION'))

tests/Components/CalendarTest.php

@@ -154,6 +154,18 @@ public function a_refresh_rate_can_be_set()
             ->expectParameterValue('VALUE', 'DURATION');
     }
 
+    /** @test */
+    public function a_source_can_be_set()
+    {
+        $payload = Calendar::create()
+            ->source('https://example.org/cal.ics')
+            ->resolvePayload();
+
+        PropertyExpectation::create($payload, 'SOURCE')
+            ->expectValue('https://example.org/cal.ics')
+            ->expectParameterValue('VALUE', 'URI');
+    }
+
     /** @test */
     public function it_will_automatically_add_multiple_timezone_components()
     {