breadcrumb-the-shire/core/Service/Tenant/TenantLogoService.php

<?php

namespace MintyPHP\Service\Tenant;

use MintyPHP\Service\Image\ImageUploadTrait;

/**
 * Tenant-scoped brand logo with per-theme variants (light + dark).
 *
 * Storage layout: storage/tenants/{uuid}/logo/{light|dark}/
 * Each theme directory holds one original file plus three resized variants
 * (128/256/512). Consumers that lack a theme context (PDF, e-mail) always ask
 * for 'light' — this is the by-design invariant.
 *
 * The theme parameter is whitelisted on every public method; invalid values
 * short-circuit to empty results so callers never need to repeat the check.
 *
 * @api
 */
class TenantLogoService
{
    use ImageUploadTrait;

    public const THEME_LIGHT = 'light';
    public const THEME_DARK = 'dark';

    /** @var list<string> */
    public const THEMES = [self::THEME_LIGHT, self::THEME_DARK];

    private const MAX_SIZE = 5242880; // 5 MB
    private const SIZES = [128, 256, 512];
    private const DEFAULT_SIZE = 256;

    public function isValidUuid(string $uuid): bool
    {
        return self::imageIsValidUuid($uuid);
    }

    public function isValidTheme(string $theme): bool
    {
        return in_array($theme, self::THEMES, true);
    }

    public function storageBase(): string
    {
        return self::imageStorageBase();
    }

    public function tenantLogoDir(string $uuid, string $theme): string
    {
        return $this->storageBase() . '/tenants/' . $uuid . '/logo/' . $theme;
    }

    public function findLogoPath(string $uuid, string $theme, ?int $size = null): ?string
    {
        if (!$this->isValidUuid($uuid) || !$this->isValidTheme($theme)) {
            return null;
        }
        $dir = $this->tenantLogoDir($uuid, $theme);
        if (!is_dir($dir)) {
            return null;
        }
        if ($size) {
            $size = $this->normalizeSize($size);
            $variant = $this->findVariantPath($dir, $size);
            if ($variant) {
                return $variant;
            }
        }
        $defaultVariant = $this->findVariantPath($dir, self::DEFAULT_SIZE);
        if ($defaultVariant) {
            return $defaultVariant;
        }
        $original = self::imageFindOriginalPath($dir);
        return $original ?: null;
    }

    public function hasLogo(string $uuid, string $theme): bool
    {
        $path = $this->findLogoPath($uuid, $theme);
        return $path ? is_file($path) : false;
    }

    public function delete(string $uuid, string $theme): bool
    {
        if (!$this->isValidUuid($uuid) || !$this->isValidTheme($theme)) {
            return false;
        }
        $dir = $this->tenantLogoDir($uuid, $theme);
        if (!is_dir($dir)) {
            return true;
        }
        $matches = array_merge(
            glob($dir . '/logo-*.*') ?: [],
            glob($dir . '/logo.*') ?: [],
            glob($dir . '/original.*') ?: []
        );
        foreach ($matches as $file) {
            if (is_file($file)) {
                @unlink($file);
            }
        }
        return true;
    }

    public function saveUpload(string $uuid, string $theme, array $file): array
    {
        if (!$this->isValidUuid($uuid)) {
            return ['ok' => false, 'error' => t('Tenant not found')];
        }
        if (!$this->isValidTheme($theme)) {
            return ['ok' => false, 'error' => t('Invalid theme')];
        }
        if (empty($file) || !isset($file['tmp_name'])) {
            return ['ok' => false, 'error' => t('No file uploaded')];
        }
        if (($file['error'] ?? UPLOAD_ERR_NO_FILE) !== UPLOAD_ERR_OK) {
            return ['ok' => false, 'error' => t('Upload failed')];
        }
        if (($file['size'] ?? 0) > self::MAX_SIZE) {
            return ['ok' => false, 'error' => t('File is too large')];
        }

        $tmpPath = $file['tmp_name'];
        $mime = $this->detectMime($tmpPath);
        $isSvg = self::imageIsSvgUpload($mime, $tmpPath);
        $ext = self::imageExtensionForMime($mime, $isSvg);
        if (!$ext) {
            return ['ok' => false, 'error' => t('Invalid image file')];
        }
        if ($isSvg && !self::imageIsSafeSvg($tmpPath)) {
            return ['ok' => false, 'error' => t('Invalid image file')];
        }

        $dir = $this->tenantLogoDir($uuid, $theme);
        if (!is_dir($dir) && !mkdir($dir, 0755, true) && !is_dir($dir)) {
            return ['ok' => false, 'error' => t('Upload failed')];
        }

        $this->delete($uuid, $theme);
        $originalPath = $dir . '/original.' . $ext;
        if (!move_uploaded_file($tmpPath, $originalPath)) {
            return ['ok' => false, 'error' => t('Upload failed')];
        }
        @chmod($originalPath, 0644);

        $variantExt = function_exists('imagewebp') ? 'webp' : 'jpg';
        if (!$isSvg && self::imageCanResize()) {
            foreach (self::SIZES as $size) {
                $target = $dir . '/logo-' . $size . '.' . $variantExt;
                self::imageResizeAndFit($originalPath, $target, $size, $size, $variantExt);
            }
        }

        return ['ok' => true, 'path' => $originalPath, 'mime' => $mime];
    }

    public function detectMime(string $path): string
    {
        return self::imageDetectMime($path);
    }

    private function normalizeSize(int $size): int
    {
        if (in_array($size, self::SIZES, true)) {
            return $size;
        }
        return self::DEFAULT_SIZE;
    }

    private function findVariantPath(string $dir, int $size): ?string
    {
        $matches = glob($dir . '/logo-' . $size . '.*');
        if (!$matches) {
            return null;
        }
        usort($matches, static function ($a, $b) {
            return filemtime($b) <=> filemtime($a);
        });
        return $matches[0];
    }
}