libredte\lib\Core\Package\Billing\Component\Document\Worker\ValidatorWorker

Complexity

Total Complexity

11

Size/Duplication

Total Lines	96
Duplicated Lines	0 %

Test Coverage

Coverage

83.33%

Importance

Changes	1
Bugs	0	Features	0

4 Methods

Rating	Name	Duplication	Size	Complexity
A	validateSignature()	0	9	2
A	validateSchema()	0	28	4
A	validate()	0	28	4
A	__construct()	0	11	1

<?php

declare(strict_types=1);

/**
 * LibreDTE: Biblioteca PHP (Núcleo).
 * Copyright (C) LibreDTE <https://www.libredte.cl>
 *
 * Este programa es software libre: usted puede redistribuirlo y/o modificarlo
 * bajo los términos de la Licencia Pública General Affero de GNU publicada por
 * la Fundación para el Software Libre, ya sea la versión 3 de la Licencia, o
 * (a su elección) cualquier versión posterior de la misma.
 *
 * Este programa se distribuye con la esperanza de que sea útil, pero SIN
 * GARANTÍA ALGUNA; ni siquiera la garantía implícita MERCANTIL o de APTITUD
 * PARA UN PROPÓSITO DETERMINADO. Consulte los detalles de la Licencia Pública
 * General Affero de GNU para obtener una información más detallada.
 *
 * Debería haber recibido una copia de la Licencia Pública General Affero de
 * GNU junto a este programa.
 *
 * En caso contrario, consulte <http://www.gnu.org/licenses/agpl.html>.
 */

namespace libredte\lib\Core\Package\Billing\Component\Document\Worker;

use Derafu\Backbone\Abstract\AbstractWorker;
use Derafu\Backbone\Attribute\Worker;
use Derafu\Backbone\Trait\StrategiesAwareTrait;
use Derafu\Signature\Contract\SignatureServiceInterface;
use Derafu\Xml\Contract\XmlDocumentInterface;
use Derafu\Xml\Contract\XmlServiceInterface;
use Derafu\Xml\XmlDocument;
use libredte\lib\Core\Package\Billing\Component\Document\Contract\DocumentBagInterface;
use libredte\lib\Core\Package\Billing\Component\Document\Contract\DocumentBagManagerWorkerInterface;
use libredte\lib\Core\Package\Billing\Component\Document\Contract\ValidatorStrategyInterface;
use libredte\lib\Core\Package\Billing\Component\Document\Contract\ValidatorWorkerInterface;
use libredte\lib\Core\Package\Billing\Component\Document\Exception\ValidatorException;

/**
 * Clase para los validadores de documentos.
 */
#[Worker(name: 'validator', component: 'document', package: 'billing')]
class ValidatorWorker extends AbstractWorker implements ValidatorWorkerInterface
{
    use StrategiesAwareTrait;

    public function __construct(
        private DocumentBagManagerWorkerInterface $documentBagManager,
        private XmlServiceInterface $xmlService,
        private SignatureServiceInterface $signatureService,
        iterable $jobs = [],
        iterable $handlers = [],
        iterable $strategies = []
    ) {
        $this->setJobs($jobs);
        $this->setHandlers($handlers);
        $this->setStrategies($strategies);
    }

    /**
     * {@inheritDoc}
     */
    public function validate(
        DocumentBagInterface|XmlDocumentInterface|string $source
    ): void {
        // Asignar la bolsa del DTE a partir de la fuente.
        if (is_string($source)) {
            // Importante: Esto quitará la firma, no sirve para otras
            // validaciones (de esquema o firma). Solo para esta validación que
            // solo valida los datos contenidos en el documento.
            $source = 'parser.strategy.default.xml:' . $source;
        }
        $bag = $source instanceof DocumentBagInterface
            ? $source
            : $this->documentBagManager->create($source)
        ;

        // Si no hay tipo de documento no se podrá normalizar.
        if (!$bag->getTipoDocumento()) {
            throw new ValidatorException(
                'No es posible validar sin un TipoDocumento en la $bag.'
            );
        }

        // Buscar la estrategia para validar el tipo de documento tributario.
        $strategy = $this->getStrategy($bag->getTipoDocumento()->getAlias());

It seems like $bag->getTipoDocumento()->getAlias() can also be of type null; however, parameter $strategy of libredte\lib\Core\Package\Billing\Component\Document\Worker\ValidatorWorker::getStrategy() does only seem to accept string, maybe add an additional type check?

        assert($strategy instanceof ValidatorStrategyInterface);

        // Validar el documento usando la estrategia.
        $strategy->validate($bag);
    }

    /**
     * {@inheritDoc}
     */
    public function validateSchema(
        DocumentBagInterface|XmlDocumentInterface|string $source
    ): void {
        // Obtener el documento XML.
        if ($source instanceof DocumentBagInterface) {
            $xmlDocument = $source->getXmlDocument();
        } elseif ($source instanceof XmlDocumentInterface) {
            $xmlDocument = $source;
        } else {
            // Importante: Hacerlo de esta forma garantiza que no se pierda el
            // nodo Signature. Pues se carga el XML completo a XmlDocument.
            $xmlDocument = new XmlDocument();
            $xmlDocument->loadXml($source);
        }

        // Crear una bolsa con el documento XML. Con esto se obtendrá en la
        // bolsa el tipo de documento asociado al DTE.
        $bag = $this->documentBagManager->create($xmlDocument, normalizeAll: false);

        // Las boletas no se validan de manera individual (el DTE). Se validan
        // a través del EnvioBOLETA.
        if ($bag->getTipoDocumento()->esBoleta()) {
            return;
        }

        // Validar esquema de otros DTE (no boletas).
        $schema = dirname(__DIR__, 6) . '/resources/schemas/DTE_v10.xsd';
        $this->xmlService->validate($bag->getXmlDocument(), $schema);

It seems like $bag->getXmlDocument() can also be of type null; however, parameter $xml of Derafu\Xml\Contract\XmlValidatorInterface::validate() does only seem to accept Derafu\Xml\Contract\XmlDocumentInterface, maybe add an additional type check?

    }

    /**
     * {@inheritDoc}
     */
    public function validateSignature(
        DocumentBagInterface|XmlDocumentInterface|string $source
    ): void {
        $xml = $source instanceof DocumentBagInterface
            ? $source->getXmlDocument()
            : $source
        ;

        $this->signatureService->validateXml($xml);

It seems like $xml can also be of type null; however, parameter $xml of Derafu\Signature\Contract\SignatureValidatorInterface::validateXml() does only seem to accept Derafu\Xml\Contract\XmlDocumentInterface|string, maybe add an additional type check?

    }
}