Add HasStatuses trait and supporting code

database/factories/StatusFactory.php

@@ -6,32 +6,21 @@
 
 use Illuminate\Database\Eloquent\Factories\Factory;
 use Illuminate\Support\Str;
-use Tipoff\Forms\Models\Status;
+use Tipoff\Statuses\Models\Status;
 
 class StatusFactory extends Factory
 {
-    /**
-     * The name of the factory's corresponding model.
-     *
-     * @var string
-     */
     protected $model = Status::class;
 
-    /**
-     * Define the model's default state.
-     *
-     * @return array
-     */
     public function definition()
     {
-        $word1 = $this->faker->unique->word;
-        $word2 = $this->faker->word;
+        $type = $this->faker->randomElement(['order', 'slot', 'game', 'invoice', 'payment']);
+        $words = $this->faker->unique()->words(2, true);
 
         return [
-            'slug' => Str::slug(rand(1, 1000).'-'.$word1.'-'.$word2),
-            'name' => $word1.' '.$word2,
-            'applies_to' => $this->faker->randomElement(['order', 'slot', 'game', 'invoice', 'payment']),
-            'note' => $this->faker->sentences(1, true),
+            'name' => $words,
+            'type' => $type,
+            'note' => $this->faker->optional()->sentences(1, true),
         ];
     }
 }

database/factories/StatusableFactory.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tipoff\Statuses\Database\Factories;
+
+use Illuminate\Database\Eloquent\Factories\Factory;
+use Illuminate\Support\Str;
+use Tipoff\Authorization\Models\User;
+use Tipoff\Statuses\Models\Status;
+use Tipoff\Statuses\Models\Statusable;
+
+class StatusableFactory extends Factory
+{
+    protected $model = Statusable::class;
+
+    public function definition()
+    {
+        $statusable = User::factory()->create();
+
+        return [
+            'status_id' => randomOrCreate(Status::class),
+            'statusable_type' => get_class($statusable),
+            'statusable_id' => $statusable->id,
+            'creator_id' => randomOrCreate(app('user')),
+        ];
+    }
+}

database/migrations/2020_05_08_100000_create_statuses_table.php

@@ -13,10 +13,12 @@ public function up()
         Schema::create('statuses', function (Blueprint $table) {
             $table->id();
             $table->string('slug')->unique()->index();
-            $table->string('name')->unique();
-            $table->string('applies_to')->default('order'); // Values include 'order', 'slot', 'game', 'invoice', 'payment'
+            $table->string('name');
+            $table->string('type');     // Typically, full class name for model using status
             $table->text('note')->nullable();
             $table->timestamps();
+
+            $table->unique(['name', 'type']);
         });
     }
 }

src/Exceptions/StatusException.php

@@ -0,0 +1,9 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tipoff\Statuses\Exceptions;
+
+interface StatusException
+{
+}

src/Exceptions/UnknownStatusException.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tipoff\Statuses\Exceptions;
+
+use Throwable;
+
+class UnknownStatusException extends \InvalidArgumentException implements StatusException
+{
+    public function __construct(string $type, string $name, $code = 0, Throwable $previous = null)
+    {
+        parent::__construct("Unknown status value '{$name}' for status type {$type}", $code, $previous);
+    }
+}

src/Models/Status.php

@@ -4,12 +4,89 @@
 
 namespace Tipoff\Statuses\Models;
 
+use Assert\Assert;
+use Carbon\Carbon;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Support\Collection;
+use Illuminate\Support\Str;
+use Tipoff\Discounts\Models\Discount;
 use Tipoff\Support\Models\BaseModel;
 use Tipoff\Support\Traits\HasPackageFactory;
 
+/**
+ * @property int id
+ * @property string name
+ * @property string type
+ * @property string slug
+ * @property string note
+ * @property Carbon created_at
+ * @property Carbon updated_at
+ */
 class Status extends BaseModel
 {
     use HasPackageFactory;
 
-    protected $casts = [];
+    protected $casts = [
+        'id' => 'integer',
+    ];
+
+    protected $fillable = [
+        'type',
+        'name',
+    ];
+
+    public static function publishStatuses(string $type, array $names): Collection
+    {
+        return collect($names)
+            ->map(function (string $name) use ($type) {
+                return static::createStatus($type, $name);
+            });
+    }
+
+    public static function createStatus(string $type, string $name, ?string $note = null): self
+    {
+        /** @var Status $status */
+        $status = static::query()->firstOrNew([
+            'type' => $type,
+            'name' => $name
+        ]);
+
+        if ($note) {
+            $status->note = $note;
+        }
+
+        $status->save();
+
+        return $status;
+    }
+
+    public static function findStatus(string $type, string $name): ?self
+    {
+        /** @var Status $status */
+        $status = static::query()
+            ->byType($type)
+            ->where('name', '=', $name)
+            ->first();
+
+        return $status;
+    }
+
+    protected static function boot()
+    {
+        parent::boot();
+
+        static::creating(function (Status $status) {
+            $status->slug = $status->slug ?: Str::slug("{$status->type}-{$status->name}");
+        });
+    }
+
+    public function scopeByType(Builder $query, string $type): Builder
+    {
+        return $query->where('type', '=', $type);
+    }
+
+    public function __toString()
+    {
+        return $this->name;
+    }
 }

src/Models/Statusable.php

@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tipoff\Statuses\Models;
+
+use Carbon\Carbon;
+use Illuminate\Database\Eloquent\Model;
+use Tipoff\Authorization\Models\User;
+use Tipoff\Support\Models\BaseModel;
+use Tipoff\Support\Traits\HasCreator;
+use Tipoff\Support\Traits\HasPackageFactory;
+
+/**
+ * @property int id
+ * @property Status status
+ * @property Model statusable
+ * @property User creator
+ * @property Carbon created_at
+ * @property Carbon updated_at
+ * // Raw Relations
+ * @property int|null creator_id
+ */
+class Statusable extends BaseModel
+{
+    use HasPackageFactory;
+    use HasCreator;
+
+    protected $casts = [
+        'id' => 'integer',
+        'creator_id' => 'integer',
+    ];
+
+    public function status()
+    {
+        return $this->belongsTo(Status::class);
+    }
+
+    public function statusable()
+    {
+        return $this->morphTo();
+    }
+}

src/Traits/HasStatuses.php

@@ -0,0 +1,65 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tipoff\Statuses\Traits;
+
+
+use Tipoff\Statuses\Exceptions\UnknownStatusException;
+use Tipoff\Statuses\Models\Status;
+use Tipoff\Statuses\Models\Statusable;
+
+/**
+ * @property Statusable statusable
+ */
+trait HasStatuses
+{
+    // When true, new statuses will be added automatically on first use
+    // When false, exception occurs if unknown status value is used
+    protected bool $dynamicStatusCreation = false;
+
+    // Assumes models can only have a single type of status
+    public function statusType(): string
+    {
+        // Default to using full class name as type
+        return get_class($this);
+    }
+
+    public function status(?string $name = null): ?Status
+    {
+        /** @var Statusable|null $statusable */
+        $statusable = $this->statusable;
+
+        if ($name) {
+            $status = $this->getStatusByName($name);
+
+            if (!$statusable) {
+                $statusable = new Statusable();
+                $statusable->statusable()->associate($this);
+            }
+
+            $statusable->status()->associate($status)->save();
+            $this->load('statusable');
+        }
+
+        return $statusable ? $statusable->status : null;
+    }
+
+    public function statusable()
+    {
+        return $this->morphOne(Statusable::class, 'statusable');
+    }
+
+    private function getStatusByName(string $name): Status
+    {
+        if ($this->dynamicStatusCreation) {
+            return Status::createStatus($this->statusType(), $name);
+        }
+
+        if ($status = Status::findStatus($this->statusType(), $name)) {
+            return $status;
+        }
+
+        throw new UnknownStatusException($this->statusType(), $name);
+    }
+}

tests/TestCase.php

@@ -8,9 +8,9 @@
 use Spatie\Permission\PermissionServiceProvider;
 use Tipoff\Authorization\AuthorizationServiceProvider;
 use Tipoff\Statuses\StatusesServiceProvider;
-use Tipoff\Statuses\Tests\Support\Providers\NovaPackageServiceProvider;
 use Tipoff\Support\SupportServiceProvider;
 use Tipoff\TestSupport\BaseTestCase;
+use Tipoff\TestSupport\Providers\NovaPackageServiceProvider;
 
 class TestCase extends BaseTestCase
 {