Add logs events table (#41)

Author: danilopolani

database/migrations/2024_03_20_000001_create_log_events_table.php

@@ -0,0 +1,28 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('log_events', function (Blueprint $table) {
+            $table->uuid('id')->primary();
+            $table->foreignUuid('log_id')->index()->constrained()->cascadeOnDelete();
+            $table->string('name');
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('log_events');
+    }
+};

src/Models/Log.php

@@ -21,6 +21,7 @@
  * @property \MailCarrier\Enums\LogStatus $status
  * @property string|null $trigger
  * @property string|null $subject
+ * @property string|null $message_id
  * @property \MailCarrier\Dto\ContactDto $sender
  * @property \MailCarrier\Dto\ContactDto|null $replyTo
  * @property \Illuminate\Support\Collection<MailCarrier\Dto\ContactDto>|null $cc
@@ -37,6 +38,7 @@
  * @property array|null $metadata
  * @property-read \MailCarrier\Models\Template|null $template
  * @property-read \Illuminate\Database\Eloquent\Collection<int, \MailCarrier\Models\Attachment> $attachments
+ * @property-read \Illuminate\Database\Eloquent\Collection<int, \MailCarrier\Models\LogEvent> $events
  */
 class Log extends Model
 {
@@ -119,6 +121,14 @@ public function attachments(): HasMany
         return $this->hasMany(Attachment::class);
     }
 
+    /**
+     * Get the log's events.
+     */
+    public function events(): HasMany
+    {
+        return $this->hasMany(LogEvent::class);
+    }
+
     /**
      * Get the prunable model query.
      */

src/Models/LogEvent.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace MailCarrier\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use MailCarrier\Models\Concerns\IsUuid;
+
+/**
+ * @property string $id
+ * @property string $log_id
+ * @property string $name
+ * @property \Carbon\CarbonImmutable $created_at
+ * @property \Carbon\CarbonImmutable $updated_at
+ * @property-read \MailCarrier\Models\Log $log
+ */
+class LogEvent extends Model
+{
+    use HasFactory;
+    use IsUuid;
+
+    /**
+     * Indicates if the IDs are auto-incrementing.
+     */
+    public $incrementing = false;
+
+    /**
+     * The data type of the auto-incrementing ID.
+     */
+    protected $keyType = 'string';
+
+    /**
+     * The attributes that are mass assignable.
+     *
+     * @var array<int, string>
+     */
+    protected $fillable = [
+        'log_id',
+        'name',
+    ];
+
+    /**
+     * Get the log that owns the event.
+     */
+    public function log(): BelongsTo
+    {
+        return $this->belongsTo(Log::class);
+    }
+}