Merge pull request #36 from JosephGabito/joseph/dto-file-generic-is-type-check

Adds a new `isType(string $type): bool` method to the File DTO, enabling specific MIME type checking beyond the existing predefined type methods.

Author: felixarntz

src/Files/DTO/File.php

@@ -87,10 +87,11 @@ private function detectAndProcessFile(string $file, ?string $providedMimeType):
             return;
         }
 
-        // Check if it's a data URI
+        // Data URI pattern.
         $dataUriPattern = '/^data:(?:([a-zA-Z0-9][a-zA-Z0-9!#$&\-\^_+.]*\/[a-zA-Z0-9][a-zA-Z0-9!#$&\-\^_+.]*'
-            . '(?:;[a-zA-Z0-9\-]+=[a-zA-Z0-9\-]+)*)?;)?base64,([A-Za-z0-9+\/]*={0,2})$/';
+        . '(?:;[a-zA-Z0-9\-]+=[a-zA-Z0-9\-]+)*)?;)?base64,([A-Za-z0-9+\/]*={0,2})$/';
 
+        // Check if it's a data URI.
         if (preg_match($dataUriPattern, $file, $matches)) {
             $this->fileType = FileTypeEnum::inline();
             $this->base64Data = $matches[2]; // Extract just the base64 data
@@ -285,6 +286,20 @@ public function isText(): bool
         return $this->mimeType->isText();
     }
 
+    /**
+     * Checks if the file is a specific MIME type.
+     *
+     * @since n.e.x.t
+     *
+     * @param string $type The mime type to check (e.g. 'image', 'text', 'video', 'audio').
+     *
+     * @return bool True if the file is of the specified type.
+     */
+    public function isMimeType(string $type): bool
+    {
+        return $this->mimeType->isType($type);
+    }
+
     /**
      * Determines the MIME type from various sources.
      *

tests/unit/Files/DTO/FileTest.php

@@ -207,6 +207,10 @@ public function testMimeTypeMethods(): void
         $this->assertFalse($file->isImage());
         $this->assertFalse($file->isAudio());
         $this->assertFalse($file->isText());
+        $this->assertTrue($file->isMimeType('video'));
+        $this->assertFalse($file->isMimeType('image'));
+        $this->assertFalse($file->isMimeType('audio'));
+        $this->assertFalse($file->isMimeType('text'));
     }
 
     /**