Add NoDiscard attributes

psalm.xml

@@ -14,4 +14,7 @@
             <directory name="vendor" />
         </ignoreFiles>
     </projectFiles>
+    <issueHandlers>
+        <UndefinedAttributeClass errorLevel="suppress" />
+    </issueHandlers>
 </psalm>

src/Manager.php

@@ -14,15 +14,18 @@ interface Manager
     /**
      * @return Maybe<Session>
      */
+    #[\NoDiscard]
     public function start(ServerRequest $request): Maybe;
 
     /**
      * @return Maybe<SideEffect>
      */
+    #[\NoDiscard]
     public function save(Session $session): Maybe;
 
     /**
      * @return Maybe<SideEffect>
      */
+    #[\NoDiscard]
     public function close(Session $session): Maybe;
 }

src/Manager/Native.php

@@ -32,6 +32,7 @@ private function __construct(?Path $save = null)
         }
     }
 
+    #[\NoDiscard]
     public static function of(?Path $save = null): self
     {
         return new self($save);

src/Session.php

@@ -38,16 +38,19 @@ private function __construct(Id $id, Name $name, Map $values)
      *
      * @param Map<string, mixed> $values
      */
+    #[\NoDiscard]
     public static function of(Id $id, Name $name, Map $values): self
     {
         return new self($id, $name, $values);
     }
 
+    #[\NoDiscard]
     public function id(): Id
     {
         return $this->id;
     }
 
+    #[\NoDiscard]
     public function name(): Name
     {
         return $this->name;
@@ -58,6 +61,7 @@ public function name(): Name
      *
      * @throws LogicException
      */
+    #[\NoDiscard]
     public function get(string $key): mixed
     {
         return $this->maybe($key)->match(
@@ -69,16 +73,19 @@ public function get(string $key): mixed
     /**
      * @return Maybe<mixed>
      */
+    #[\NoDiscard]
     public function maybe(string $key): Maybe
     {
         return $this->values->get($key);
     }
 
+    #[\NoDiscard]
     public function contains(string $key): bool
     {
         return $this->values->contains($key);
     }
 
+    #[\NoDiscard]
     public function with(string $key, mixed $value): self
     {
         return new self(
@@ -95,6 +102,7 @@ public function with(string $key, mixed $value): self
      *
      * @return Map<string, mixed>
      */
+    #[\NoDiscard]
     public function values(): Map
     {
         return $this->values;

src/Session/Id.php

@@ -25,13 +25,15 @@ private function __construct(string $value)
      *
      * @return Maybe<self>
      */
+    #[\NoDiscard]
     public static function maybe(string $value): Maybe
     {
         return Maybe::just(Str::of($value))
             ->filter(static fn($value) => $value->matches('~^[\w\-\_]+$~'))
             ->map(static fn($value) => new self($value->toString()));
     }
 
+    #[\NoDiscard]
     public function toString(): string
     {
         return $this->value;

src/Session/Name.php

@@ -26,13 +26,15 @@ private function __construct(string $value)
      *
      * @return Maybe<self>
      */
+    #[\NoDiscard]
     public static function maybe(string $value): Maybe
     {
         return Maybe::just(Str::of($value))
             ->filter(static fn($value) => $value->matches('~^[\w\-\_]+$~'))
             ->map(static fn($value) => new self($value->toString()));
     }
 
+    #[\NoDiscard]
     public function toString(): string
     {
         return $this->value;