add event

src/Events/MediaFileStoredEvent.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace Finller\Media\Events;
+
+use Finller\Media\Models\Media;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+
+/**
+ * Disptached when any new file
+ */
+class MediaFileStoredEvent
+{
+    use Dispatchable, SerializesModels;
+
+    /**
+     * Create a new event instance.
+     *
+     * @return void
+     */
+    public function __construct(public Media $media, public string $path)
+    {
+        //
+    }
+}

src/Models/Media.php

@@ -6,6 +6,7 @@
 use Finller\Media\Casts\GeneratedConversion;
 use Finller\Media\Casts\GeneratedConversions;
 use Finller\Media\Enums\MediaType;
+use Finller\Media\Events\MediaFileStoredEvent;
 use Finller\Media\FileDownloaders\FileDownloader;
 use Finller\Media\Helpers\File;
 use Finller\Media\Support\ResponsiveImagesConversionsPreset;
@@ -300,7 +301,8 @@ public function storeFileFromHttpFile(
         $this->file_name = "{$this->name}.{$this->extension}";
         $this->path = Str::finish($basePath ?? $this->generateBasePath(), '/').$this->file_name;
 
-        $this->putFile($file, fileName: $this->file_name);
+        $path = $this->putFile($file, fileName: $this->file_name);
+        event(new MediaFileStoredEvent($this, $path));
 
         $this->save();
 
@@ -382,7 +384,8 @@ public function storeFile(
         }
 
         foreach ($otherFiles as $otherFile) {
-            $this->putFile($otherFile);
+            $path = $this->putFile($otherFile);
+            event(new MediaFileStoredEvent($this, $path));
         }
 
         return $this;
@@ -409,7 +412,8 @@ public function storeConversion(
         }
 
         foreach ($otherFiles as $otherFile) {
-            $this->putFile($otherFile);
+            $path = $this->putFile($otherFile);
+            event(new MediaFileStoredEvent($this, $path));
         }
 
         return $generatedConversion;
@@ -475,7 +479,8 @@ public function storeConversionFromHttpFile(
 
         $this->putGeneratedConversion($conversion, $generatedConversion);
 
-        $generatedConversion->putFile($file, fileName: $generatedConversion->file_name);
+        $path = $generatedConversion->putFile($file, fileName: $generatedConversion->file_name);
+        event(new MediaFileStoredEvent($this, $path));
 
         $this->save();
 

src/Traits/InteractsWithMediaFiles.php

@@ -101,10 +101,7 @@ public function putFile(
         string|UploadedFile|HttpFile $file,
         ?string $name = null,
         ?string $fileName = null,
-    ): string|false {
-        if (! $this->path) {
-            throw new Exception('['.static::class.']'."Can't put a file to the instance because the main path is not defined");
-        }
+    ): string {
 
         if (is_string($file) && filter_var($file, FILTER_VALIDATE_URL)) {
             $file = new HttpFile(FileDownloader::getTemporaryFile($file));