FilesystemPdfImageEmbedder.php

<?php

// SPDX-FileCopyrightText: 2026 LibreSign
// SPDX-License-Identifier: AGPL-3.0-or-later

declare(strict_types=1);

namespace LibreSign\XObjectTemplate\Pdf;

use InvalidArgumentException;
use LibreSign\XObjectTemplate\Pdf\Jpeg\JpegPdfImageFactory;
use LibreSign\XObjectTemplate\Pdf\Jpeg\JpegPdfImageFactoryInterface;
use LibreSign\XObjectTemplate\Pdf\Png\PngPdfImageFactory;
use LibreSign\XObjectTemplate\Pdf\Png\PngPdfImageFactoryInterface;
use LibreSign\XObjectTemplate\Pdf\Svg\SvgPdfXObjectFactory;
use LibreSign\XObjectTemplate\Pdf\Svg\SvgPdfXObjectFactoryInterface;

final readonly class FilesystemPdfImageEmbedder implements PdfImageEmbedderInterface
{
    private FilesystemImageSourceReaderInterface $sourceReader;
    private ImageMetadataInspectorInterface $metadataInspector;
    private JpegPdfImageFactoryInterface $jpegImageFactory;
    private PngPdfImageFactoryInterface $pngImageFactory;
    private SvgPdfXObjectFactoryInterface $svgXObjectFactory;

    public function __construct(
        ?FilesystemImageSourceReaderInterface $sourceReader = null,
        ?ImageMetadataInspectorInterface $metadataInspector = null,
        ?JpegPdfImageFactoryInterface $jpegImageFactory = null,
        ?PngPdfImageFactoryInterface $pngImageFactory = null,
        ?SvgPdfXObjectFactoryInterface $svgXObjectFactory = null,
    ) {
        $this->sourceReader = $sourceReader ?? new FilesystemImageSourceReader();
        $this->metadataInspector = $metadataInspector ?? new ImageMetadataInspector();
        $this->jpegImageFactory = $jpegImageFactory ?? new JpegPdfImageFactory();
        $this->pngImageFactory = $pngImageFactory ?? new PngPdfImageFactory();
        $this->svgXObjectFactory = $svgXObjectFactory ?? new SvgPdfXObjectFactory();
    }

    public function embed(string $source): EmbeddedPdfImage
    {
        $contents = $this->sourceReader->read($source);

        if ($this->isSvgSource($source, $contents)) {
            return $this->svgXObjectFactory->create($contents, $source);
        }

        $imageInfo = $this->metadataInspector->detect($contents, $source);
        $mime = $this->metadataInspector->resolveMimeType($imageInfo, $source);

        return match ($mime) {
            'image/jpeg' => $this->jpegImageFactory->create($contents, $imageInfo),
            'image/png' => $this->pngImageFactory->create($contents),
            default => throw new InvalidArgumentException(
                sprintf('Unsupported image format "%s".', $mime),
            ),
        };
    }

    private function isSvgSource(string $source, string $contents): bool
    {
        if (preg_match('/\.svgz?$/i', $source) === 1) {
            return true;
        }

        $trimmed = ltrim($contents);

        return str_starts_with($trimmed, '<svg')
            || (str_starts_with($trimmed, '<?xml') && str_contains($trimmed, '<svg'));
    }
}