File::detectAndProcessFile( string $file, string|null $providedMimeType )

73    private function detectAndProcessFile(string $file, ?string $providedMimeType): void74    {75        // Check if it's a URL76        if ($this->isUrl($file)) {77            $this->fileType = FileTypeEnum::remote();78            $this->url = $file;79            $this->mimeType = $this->determineMimeType($providedMimeType, null, $file);80            return;81        }82        // Data URI pattern.83        $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})$/';84        // Check if it's a data URI.85        if (preg_match($dataUriPattern, $file, $matches)) {86            $this->fileType = FileTypeEnum::inline();87            $this->base64Data = $matches[2];88            // Extract just the base64 data89            $extractedMimeType = empty($matches[1]) ? null : $matches[1];90            $this->mimeType = $this->determineMimeType($providedMimeType, $extractedMimeType, null);91            return;92        }93        // Check if it's a local file path (before base64 check)94        if (file_exists($file) && is_file($file)) {95            $this->fileType = FileTypeEnum::inline();96            $this->base64Data = $this->convertFileToBase64($file);97            $this->mimeType = $this->determineMimeType($providedMimeType, null, $file);98            return;99        }100        // Check if it's plain base64101        if (preg_match('/^[A-Za-z0-9+\/]*={0,2}$/', $file)) {102            if ($providedMimeType === null) {103                throw new InvalidArgumentException('MIME type is required when providing plain base64 data without data URI format.');104            }105            $this->fileType = FileTypeEnum::inline();106            $this->base64Data = $file;107            $this->mimeType = new MimeType($providedMimeType);108            return;109        }110        throw new InvalidArgumentException('Invalid file provided. Expected URL, base64 data, or valid local file path.');111    }