trypost/app/Support/Social/TikTokPhotoDerivativeCleaner.php

<?php

declare(strict_types=1);

namespace App\Support\Social;

use Illuminate\Support\Facades\Log;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str;
use Throwable;

class TikTokPhotoDerivativeCleaner
{
    public const string DIRECTORY = 'social-tiktok-photos';

    /**
     * @param  array<string, mixed>|null  $context
     */
    public function cleanup(?array $context, ?string $postPlatformId = null): void
    {
        $this->cleanupPaths(PublishCheckpoint::tiktokDerivativePaths($context), $postPlatformId);
    }

    /**
     * Keep hosted photos while a publish_id can still be resumed.
     *
     * @param  array<string, mixed>|null  $context
     */
    public function cleanupUnlessPublishInFlight(?array $context, ?string $postPlatformId = null): void
    {
        if (PublishCheckpoint::tiktokPublishId($context) !== null) {
            return;
        }

        $this->cleanup($context, $postPlatformId);
    }

    /**
     * @param  array<array-key, mixed>  $paths
     */
    public function cleanupPaths(array $paths, ?string $postPlatformId = null): void
    {
        $derivativePaths = array_values(array_filter(
            $paths,
            $this->isManagedDerivativePath(...),
        ));

        if ($derivativePaths === []) {
            return;
        }

        try {
            Storage::delete($derivativePaths);
        } catch (Throwable $e) {
            Log::warning('Failed to prune TikTok photo derivatives', [
                'post_platform_id' => $postPlatformId,
                'error' => $e->getMessage(),
            ]);
        }
    }

    private function isManagedDerivativePath(mixed $path): bool
    {
        return is_string($path)
            && dirname($path) === self::DIRECTORY
            && Str::isUuid(pathinfo($path, PATHINFO_FILENAME));
    }
}