feat: add configurable HLS CORS allowlists

tests/Cors/CorsPolicyTest.php

@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugin\AzuraCastOnDemandHls\Tests\Cors;
+
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\TestCase;
+use Plugin\AzuraCastOnDemandHls\Cors\CorsPolicy;
+
+#[CoversClass(CorsPolicy::class)]
+final class CorsPolicyTest extends TestCase
+{
+    private CorsPolicy $policy;
+
+    protected function setUp(): void
+    {
+        $this->policy = new CorsPolicy(['https://aifrequency.org', 'https://www.aifrequency.org']);
+    }
+
+    public function testItAllowsTheFirstExplicitOrigin(): void
+    {
+        self::assertSame([
+            'Access-Control-Allow-Origin' => 'https://aifrequency.org',
+            'Vary' => 'Origin',
+        ], $this->policy->headersFor('https://aifrequency.org'));
+    }
+
+    public function testItAllowsTheSecondExplicitOrigin(): void
+    {
+        self::assertSame('https://www.aifrequency.org', $this->policy->headersFor('https://www.aifrequency.org')['Access-Control-Allow-Origin']);
+    }
+
+    public function testItDoesNotAllowAnUnapprovedOrigin(): void
+    {
+        self::assertSame(['Vary' => 'Origin'], $this->policy->headersFor('https://evil.example'));
+    }
+
+    public function testItDoesNotAddCorsHeadersWithoutAnOrigin(): void
+    {
+        self::assertSame([], $this->policy->headersFor(null));
+    }
+
+    public function testItBuildsAConstrainedHlsPreflightResponse(): void
+    {
+        self::assertSame([
+            'Access-Control-Allow-Origin' => 'https://aifrequency.org',
+            'Vary' => 'Origin',
+            'Access-Control-Allow-Methods' => 'GET, HEAD, OPTIONS',
+            'Access-Control-Allow-Headers' => 'Range',
+            'Access-Control-Max-Age' => '600',
+        ], $this->policy->headersFor('https://aifrequency.org', true));
+    }
+}

tests/Cors/NginxRulesTest.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugin\AzuraCastOnDemandHls\Tests\Cors;
+
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\TestCase;
+use Plugin\AzuraCastOnDemandHls\Cors\NginxRules;
+
+#[CoversClass(NginxRules::class)]
+final class NginxRulesTest extends TestCase
+{
+    public function testItWritesExactOriginRulesForTheInternalHlsLocation(): void
+    {
+        self::assertSame(
+            "            set \$ondemand_hls_cors_origin \"\";\n"
+            . "            set \$ondemand_hls_cors_vary \"\";\n"
+            . "            if (\$http_origin != \"\") { set \$ondemand_hls_cors_vary \"Origin\"; }\n"
+            . "            if (\$http_origin = \"https://aifrequency.org\") { set \$ondemand_hls_cors_origin \$http_origin; }\n"
+            . "            if (\$http_origin = \"https://www.aifrequency.org\") { set \$ondemand_hls_cors_origin \$http_origin; }\n",
+            NginxRules::forOrigins(['https://aifrequency.org', 'https://www.aifrequency.org'])
+        );
+    }
+}

tests/Cors/OriginTest.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Plugin\AzuraCastOnDemandHls\Tests\Cors;
+
+use InvalidArgumentException;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\TestCase;
+use Plugin\AzuraCastOnDemandHls\Cors\Origin;
+
+#[CoversClass(Origin::class)]
+final class OriginTest extends TestCase
+{
+    public function testItCanonicalizesAWebOrigin(): void
+    {
+        self::assertSame('https://aifrequency.org', Origin::normalize('HTTPS://AIFrequency.org/'));
+        self::assertSame('https://www.aifrequency.org', Origin::normalize('https://www.aifrequency.org'));
+        self::assertSame('https://aifrequency.org:8443', Origin::normalize('https://aifrequency.org:8443'));
+    }
+
+    public function testItRejectsPathsAndUnsafeOriginForms(): void
+    {
+        foreach (['*', 'null', 'https://aifrequency.org/path', 'https://[email protected]', 'file:///tmp/a'] as $origin) {
+            try {
+                Origin::normalize($origin);
+                self::fail(sprintf('%s should be rejected.', $origin));
+            } catch (InvalidArgumentException) {
+            }
+        }
+    }
+}