<?php

declare(strict_types=1);

namespace App\Libraries\Pipeline;

use chillerlan\QRCode\QRCode;
use chillerlan\QRCode\QROptions;

/**
 * Renders QR codes server-side (PNG) via chillerlan/php-qrcode.
 * Text-kind tool: input is `content`, options: size, level, margin.
 */
final class Qr implements DriverInterface
{
    public function handle(array $job, array $tool = [], ?callable $update = null): array
    {
        $update ??= static function (int $p, string $stage): void {
        };
        $params = json_decode($job['params'] ?? '{}', true) ?: [];

        $content = trim((string) ($params['content'] ?? ''));
        if ($content === '') {
            throw new \RuntimeException('Enter the text or URL to encode.');
        }
        if (mb_strlen($content) > 1000) {
            throw new \RuntimeException('Content too long for a QR code (max 1000 characters).');
        }

        // error-correction: L ~7%, M ~15%, Q ~25%, H ~30%
        $level = strtoupper((string) ($params['level'] ?? 'M'));
        if (! in_array($level, ['L', 'M', 'Q', 'H'], true)) {
            $level = 'M';
        }
        $size = (int) ($params['size'] ?? 300);
        $size = min(1000, max(120, $size));

        $options = new QROptions([
            'outputType'          => QRCode::OUTPUT_IMAGE_PNG,
            'eccLevel'            => constant(QRCode::class . '::ECC_' . $level),
            'scale'               => max(3, (int) round($size / 33)),
            'imageBase64'         => false,
            'quality'             => 90,
        ]);

        [, $out] = self::output($job, 'png');
        $png = (new QRCode($options))->render($content);
        if (! str_starts_with((string) $png, "\x89PNG")) {
            throw new \RuntimeException('QR rendering failed.');
        }
        file_put_contents($out, $png);

        return ['file' => basename($out), 'name' => 'qr-code.png', 'ext' => 'png'];
    }

    private static function output(array $job, string $ext): array
    {
        $dir = \App\Libraries\Pipeline::storageDir();
        $file = \App\Libraries\Pipeline::safeName($job['id'], $ext);

        return [$file, $dir . '/' . $file];
    }
}