<?php

declare(strict_types=1);

/**
 * Headless Chrome für die CLI-Werkzeuge (nur CLI, bewusst NICHT in app/helpers.php).
 *
 * Zwei Skripte brauchen einen echten Browser, beide laufen ausschließlich lokal auf einem
 * Arbeitsrechner und nie auf dem Server:
 *   - bin/logo-build.php     rastert SVG (GD kann kein SVG) und druckt Vektor-PDF
 *   - bin/instagram-add.php  liest mit --profil die Beitragsliste vom Instagram-Profil
 *
 * Auf dem All-Inkl-Webspace gibt es kein Chrome. Das ist kein Mangel, sondern die Grenze:
 * was diesen Helfer braucht, ist Chat-Arbeit und kein Cron-Job.
 */
if (PHP_SAPI !== 'cli') {
    exit(1);
}

/**
 * Pfad zu Chrome/Chromium, oder null. Reihenfolge: Umgebungsvariable CHROME, dann die
 * üblichen Installationsorte.
 */
function chrome_binary(): ?string
{
    $env = getenv('CHROME');
    if (is_string($env) && $env !== '' && is_executable($env)) {
        return $env;
    }
    foreach ([
        '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
        '/Applications/Chromium.app/Contents/MacOS/Chromium',
        '/usr/bin/google-chrome',
        '/usr/bin/chromium',
    ] as $candidate) {
        if (is_executable($candidate)) {
            return $candidate;
        }
    }

    return null;
}

/**
 * Chrome einmal aufrufen und stdout zurückgeben.
 *
 * KEIN --user-data-dir: naheliegend wäre ein eigener Profilordner, damit ein offenes
 * Chrome-Fenster den Lauf nicht stört. Chrome 152 bleibt damit aber beim ERSTEN Aufruf
 * endlos hängen (gemessen: kein Abbruch nach zwei Minuten, kein Ergebnis, keine Meldung).
 * Ohne den Schalter läuft jeder Aufruf in Sekunden durch, auch bei geöffnetem Chrome.
 * Wer hier etwas ändert, misst die Laufzeit nach.
 *
 * @param string[] $args zusätzliche Schalter, bereits shell-escaped
 */
function chrome_run(string $chrome, array $args): string
{
    $cmd = escapeshellarg($chrome)
        . ' --headless --disable-gpu --hide-scrollbars --force-color-profile=srgb'
        . ' --no-first-run --no-default-browser-check'
        . ' ' . implode(' ', $args) . ' 2>/dev/null';

    return (string) shell_exec($cmd);
}