Merge branch 'release/3.3.1'

Author: lindyhopchris

CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file. This projec
 
 ## Unreleased
 
+## [3.3.1] - 2025-08-10
+
+### Fixed
+
+- Ensure that the `Result` class uses `@template-covariant` for its result value. This now matches the result interface,
+  which already used template covariant.
+
 ## [3.3.0] - 2025-05-24
 
 ### Added

composer.json

@@ -53,7 +53,7 @@
             "@test"
         ],
         "deptrac": "deptrac analyse --report-uncovered --fail-on-uncovered",
-        "static": "phpstan analyse -c phpstan.neon",
+        "static": "phpstan analyse -c phpstan.neon --memory-limit=256M",
         "style": "pint --test",
         "style:fix": "pint",
         "test": "phpunit"

src/Toolkit/Result/Result.php

@@ -18,7 +18,7 @@
 use CloudCreativity\Modules\Contracts\Toolkit\Result\Result as IResult;
 
 /**
- * @template TValue
+ * @template-covariant TValue
  * @implements IResult<TValue>
  */
 final class Result implements IResult

tests/Unit/Application/Bus/TestCommand.php

@@ -16,4 +16,7 @@
 
 class TestCommand implements Command
 {
+    public function __construct(public bool $fail = false)
+    {
+    }
 }

tests/Unit/Application/Bus/TestCommandHandler.php

@@ -13,6 +13,8 @@
 namespace CloudCreativity\Modules\Tests\Unit\Application\Bus;
 
 use CloudCreativity\Modules\Contracts\Application\Messages\DispatchThroughMiddleware;
+use CloudCreativity\Modules\Contracts\Toolkit\Identifiers\Identifier;
+use CloudCreativity\Modules\Toolkit\Identifiers\Uuid;
 use CloudCreativity\Modules\Toolkit\Result\Result;
 
 class TestCommandHandler implements DispatchThroughMiddleware
@@ -21,11 +23,15 @@ class TestCommandHandler implements DispatchThroughMiddleware
      * Execute the command.
      *
      * @param TestCommand $command
-     * @return Result<null>
+     * @return Result<Identifier|null>
      */
     public function execute(TestCommand $command): Result
     {
-        return Result::ok();
+        if ($command->fail) {
+            return Result::fail('It failed!');
+        }
+
+        return Result::ok(Uuid::random());
     }
 
     /**