ADD allow any value to be saved against a mark (#47)

Author: digitalSloth

README.md

@@ -245,6 +245,28 @@ Reaction::has($post, $user, 'heart'); // returns whether the user has reacted wi
 Reaction::count($post, 'person_raising_hand'); // returns the amount of 'person_raising_hand' reactions for the given post
 ```
 
+You can also use wildcards to allow any value for a specific mark.
+
+Here's an example when working with reactions:
+
+``` php
+'allowed_values' => [
+    'reaction' => '*',
+],
+```
+
+When set, you can use any value when giving a reaction:
+
+``` php
+use App\Models\Post;
+use Maize\Markable\Models\Reaction;
+
+$post = Post::firstOrFail();
+$user = auth()->user();
+
+Reaction::add($post, $user, 'random_value'); // adds the 'random_value' reaction to the post for the given user
+```
+
 ### Retrieve the list of marks of an entity with eloquent
 
 ``` php

src/Mark.php

@@ -24,7 +24,7 @@ class_basename(static::class)
         )->plural()->lower()->__toString();
     }
 
-    public static function allowedValues(): ?array
+    public static function allowedValues(): array|string|null
     {
         $className = Str::lower(static::getMarkClassName());
 
@@ -100,7 +100,13 @@ public static function toggle(Model $markable, Model $user, string $value = null
 
     public static function hasAllowedValues(?string $value): bool
     {
-        return in_array($value, static::allowedValues() ?? [null]);
+        $allowedValues = static::allowedValues() ?? [null];
+
+        if ($allowedValues === '*') {
+            return true;
+        }
+
+        return in_array($value, $allowedValues);
     }
 
     public function user(): BelongsTo

tests/ReactionTest.php

@@ -29,6 +29,25 @@ public function cannot_add_an_invalid_reaction_value_fails()
         Reaction::add($article, $user, 'not_valid_value');
     }
 
+    /** @test */
+    public function can_add_any_value_with_wildcard()
+    {
+        config()->set('markable.allowed_values.reaction', '*');
+
+        $article = Article::factory()->create();
+        $user = User::factory()->create();
+        $table = (new Reaction)->getTable();
+
+        Reaction::add($article, $user, 'random_value');
+        $this->assertDatabaseCount($table, 1);
+        $this->assertDatabaseHas($table, [
+            'user_id' => $user->getKey(),
+            'markable_id' => $article->getKey(),
+            'markable_type' => $article->getMorphClass(),
+            'value' => 'random_value',
+        ]);
+    }
+
     /** @test */
     public function can_add_a_reaction()
     {