Added 'data()' function to store details about message type in 'data' column of 'message' table

README.md

@@ -185,6 +185,18 @@ $message = Chat::message('http://example.com/img')
 		->to($conversation)
 		->send();
 ```
+#### To add more details about a message
+
+Sometimes you might want to add details about a message. For example, when the message type is an attachment, and you want to add details such as attachment's filename, and attachment's file url, you can call the `data()` function and pass your data as an array.
+
+```php
+$message = Chat::message('Attachment 1')
+		->type('attachment')
+		->data(['file_name' => 'post_image.jpg', 'file_url' => 'http://example.com/post_img.jpg'])
+		->from($model)
+		->to($conversation)
+		->send();
+```
 
 ### Get a message by id
 

database/migrations/create_chat_tables.php

@@ -44,6 +44,7 @@ public function up()
             $table->bigInteger('conversation_id')->unsigned();
             $table->bigInteger('participation_id')->unsigned()->nullable();
             $table->string('type')->default('text');
+            $table->text('data')->nullable();
             $table->timestamps();
 
             $table->foreign('participation_id')

src/Eventing/MessageWasSent.php

@@ -40,6 +40,7 @@ public function broadcastWith()
                 'body'            => $this->message->body,
                 'conversation_id' => $this->message->conversation_id,
                 'type'            => $this->message->type,
+                'data'            => $this->message->data,
                 'created_at'      => $this->message->created_at,
                 'sender'          => $this->message->sender,
             ],

src/Messages/SendMessageCommand.php

@@ -10,6 +10,7 @@ class SendMessageCommand
     public $body;
     public $conversation;
     public $type;
+    public $data;
     public $participant;
 
     /**
@@ -18,11 +19,12 @@ class SendMessageCommand
      * @param Model        $sender       The sender identifier
      * @param string       $type         The message type
      */
-    public function __construct(Conversation $conversation, $body, Model $sender, $type = 'text')
+    public function __construct(Conversation $conversation, $body, Model $sender, $type = 'text', $data)
     {
         $this->conversation = $conversation;
         $this->body = $body;
         $this->type = $type;
+        $this->data = $data;
         $this->participant = $this->conversation->participantFromSender($sender);
     }
 }

src/Messages/SendMessageCommandHandler.php

@@ -30,7 +30,7 @@ public function __construct(EventDispatcher $dispatcher, Message $message)
      */
     public function handle(SendMessageCommand $command)
     {
-        $message = $this->message->send($command->conversation, $command->body, $command->participant, $command->type);
+        $message = $this->message->send($command->conversation, $command->body, $command->participant, $command->type, $command->data);
 
         $this->dispatcher->dispatch($this->message->releaseEvents());
 

src/Models/Message.php

@@ -18,6 +18,7 @@ class Message extends BaseModel
         'body',
         'participation_id',
         'type',
+        'data'
     ];
 
     protected $table = ConfigurationManager::MESSAGES_TABLE;
@@ -35,6 +36,7 @@ class Message extends BaseModel
      */
     protected $casts = [
         'flagged' => 'boolean',
+        'data' => 'array'
     ];
 
     protected $appends = ['sender'];
@@ -84,12 +86,13 @@ public function conversation()
      *
      * @return Model
      */
-    public function send(Conversation $conversation, string $body, Participation $participant, string $type = 'text'): Model
+    public function send(Conversation $conversation, string $body, Participation $participant, string $type = 'text', array $data = []): Model
     {
         $message = $conversation->messages()->create([
             'body'             => $body,
             'participation_id' => $participant->getKey(),
             'type'             => $type,
+            'data'             => $data
         ]);
 
         if (Chat::broadcasts()) {

src/Services/MessageService.php

@@ -13,6 +13,7 @@ class MessageService
     use SetsParticipants;
 
     protected $type = 'text';
+    protected $data = [];
     protected $body;
     /**
      * @var CommandBus
@@ -54,6 +55,13 @@ public function type(string $type)
         return $this;
     }
 
+    public function data(array $data)
+    {
+        $this->data = $data;
+
+        return $this;
+    }
+
     public function getById($id)
     {
         return $this->message->findOrFail($id);
@@ -120,7 +128,7 @@ public function send()
             throw new Exception('Message receiver has not been set');
         }
 
-        $command = new SendMessageCommand($this->recipient, $this->body, $this->sender, $this->type);
+        $command = new SendMessageCommand($this->recipient, $this->body, $this->sender, $this->type, $this->data);
 
         return $this->commandBus->execute($command);
     }