Gerar DABPE (PDF auxiliar)

use Suot\Fiscal\Bpe\Dabpe\Enum\DabpeTemplate;
use Suot\Fiscal\Bpe\Dabpe\Exception\DabpeXmlException;

try {
    $result = $bpe->renderDabpe()
        ->fromXml($procBpeXml)
        ->template(DabpeTemplate::Thermal80)
        ->handle();
} catch (DabpeXmlException $e) {
    // Host: XML inválido, metropolitano ou QR inconsistente (modo estrito); corrigir origem e não gerar PDF
    throw $e;
}

if ($result->isPdf()) {
    // Host: persistir pdfBytes, accessKey, pageCount; expor download / enviar à impressora
    $pdf = $result->pdfBytes();
    $chave = $result->accessKey();
    $xmlHash = $result->metadata()['xmlSha256'] ?? null;
}

foreach ($result->warnings() as $warning) {
    // Host: registrar warning.code / warning.message
}

use Suot\Fiscal\Bpe\Dabpe\Exception\DabpeXmlException;

try {
    $extract = $bpe->renderDabpe()
        ->fromXml($procBpeXml)
        ->extract();
} catch (DabpeXmlException $e) {
    // Host: XML não parseável ou metropolitano; não indexar
    throw $e;
}

$chave = $extract->accessKey();
$campos = $extract->fields(); // emitente, viagem, valores, passageiro, …
$hash = $extract->xmlSha256();

$report = $bpe->renderDabpe()
    ->fromXml($procBpeXml)
    ->validatePrintable();

if ($report->isPrintable()) {
    // Host: pode chamar ->handle() e persistir o PDF
}

if (! $report->isPrintable()) {
    foreach ($report->errors() as $issue) {
        // Host: corrigir issue.field / issue.code (SDK-XML-*, SDK-QR-*, SDK-DABPE-001, …)
    }
}