From a9f2d689ae8b8fd3a868c15432ce2a68b987f79d Mon Sep 17 00:00:00 2001
From: myrmidex <myrmidex@myrmidex.net>
Date: Sun, 26 Apr 2026 16:45:07 +0200
Subject: [PATCH] 12 - Add crawler config and FetchResult value object

---
 app/ValueObjects/FetchResult.php            | 22 ++++++++++++
 tests/Unit/ValueObjects/FetchResultTest.php | 37 +++++++++++++++++++++
 2 files changed, 59 insertions(+)
 create mode 100644 app/ValueObjects/FetchResult.php
 create mode 100644 tests/Unit/ValueObjects/FetchResultTest.php

diff --git a/app/ValueObjects/FetchResult.php b/app/ValueObjects/FetchResult.php
new file mode 100644
index 0000000..e8339dc
--- /dev/null
+++ b/app/ValueObjects/FetchResult.php
@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\ValueObjects;
+
+use App\Enums\CrawlOutcomeEnum;
+use Illuminate\Support\Collection;
+
+class FetchResult
+{
+    public function __construct(
+        public CrawlOutcomeEnum $outcome,
+        public int $statusCode,
+        public string $finalUrl,
+        public string $title,
+        public string $extractedText,
+        public Collection $outboundLinks,
+        public int $wordCount,
+        public ?string $errorMessage,
+    ) {}
+}
diff --git a/tests/Unit/ValueObjects/FetchResultTest.php b/tests/Unit/ValueObjects/FetchResultTest.php
new file mode 100644
index 0000000..852ea78
--- /dev/null
+++ b/tests/Unit/ValueObjects/FetchResultTest.php
@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Unit\ValueObjects;
+
+use App\Enums\CrawlOutcomeEnum;
+use App\ValueObjects\FetchResult;
+use Illuminate\Support\Collection;
+use PHPUnit\Framework\TestCase;
+
+class FetchResultTest extends TestCase
+{
+    public function test_it_exposes_all_fields(): void
+    {
+        $result = new FetchResult(
+            outcome: CrawlOutcomeEnum::Success,
+            statusCode: 200,
+            finalUrl: 'https://example.com/article',
+            title: 'An Example Article',
+            extractedText: 'Lorem ipsum dolor sit amet.',
+            outboundLinks: collect(['https://other.com', 'https://another.com']),
+            wordCount: 5,
+            errorMessage: null,
+        );
+
+        $this->assertSame(CrawlOutcomeEnum::Success, $result->outcome);
+        $this->assertSame(200, $result->statusCode);
+        $this->assertSame('https://example.com/article', $result->finalUrl);
+        $this->assertSame('An Example Article', $result->title);
+        $this->assertSame('Lorem ipsum dolor sit amet.', $result->extractedText);
+        $this->assertInstanceOf(Collection::class, $result->outboundLinks);
+        $this->assertSame(['https://other.com', 'https://another.com'], $result->outboundLinks->all());
+        $this->assertSame(5, $result->wordCount);
+        $this->assertNull($result->errorMessage);
+    }
+}