Gerar DAMDFE (PDF auxiliar)

use Suot\Fiscal\Mdfe\Damdfe\Enum\PaperSize;
use Suot\Fiscal\Mdfe\Damdfe\Exception\DamdfeXmlException;

try {
    $result = $mdfe->renderDamdfe()
        ->fromXml($procMdfeXml)
        ->paperSize(PaperSize::A4)
        ->handle();
} catch (DamdfeXmlException $e) {
    // Host: XML inválido ou QR inconsistente (modo estrito); corrigir origem e não gerar PDF
    throw $e;
}

if ($result->isPdf()) {
    // Host: persistir pdfBytes, accessKey, pageCount; expor download
    $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\Mdfe\Damdfe\Exception\DamdfeXmlException;

try {
    $extract = $mdfe->renderDamdfe()
        ->fromXml($procMdfeXml)
        ->extract();
} catch (DamdfeXmlException $e) {
    // Host: XML não parseável; não indexar
    throw $e;
}

$chave = $extract->accessKey();
$campos = $extract->fields(); // emitente, rodoviário, carga, CT-e, …
$hash = $extract->xmlSha256();

$report = $mdfe->renderDamdfe()
    ->fromXml($procMdfeXml)
    ->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-*, …)
    }
}