data-importer/app/Services/Camt/Conversion/TransactionConverter.php

<?php

namespace App\Services\Camt\Conversion;

use App\Exceptions\ImporterErrorException;
use App\Services\Camt\Transaction;
use App\Services\Shared\Configuration\Configuration;

class TransactionConverter
{
    private Configuration $configuration;

    /**
     * @param  Configuration  $configuration
     */
    public function __construct(Configuration $configuration)
    {
        $this->configuration = $configuration;
    }

    /**
     * @param  array  $transactions
     *
     * @return array
     * @throws ImporterErrorException
     */
    public function convert(array $transactions): array
    {
        app('log')->debug('Convert all transactions into pseudo-transactions.');
        $result = [];
        /** @var Transaction $transaction */
        foreach ($transactions as $transaction) {
            $result[] = $this->convertSingle($transaction);
        }
        app('log')->debug('Done converting all transactions into pseudo-transactions.');

        return $result;
    }

    /**
     * @param  Transaction  $transaction
     *
     * @return array
     * @throws ImporterErrorException
     */
    private function convertSingle(Transaction $transaction): array
    {
        app('log')->debug('Convert single transaction into pseudo-transaction.');
        $result           = [
            'transactions' => [],
        ];
        $configuredRoles  = $this->getConfiguredRoles();
        $mapping          = $this->configuration->getMapping();
        $allRoles         = $this->configuration->getRoles();
        $count            = $transaction->countSplits();
        $count            = 0 === $count ? 1 : $count; // add at least one transaction inside the Transaction.
        $fieldNames       = array_keys(config('camt.fields'));
        $result['splits'] = $count;

        for ($i = 0; $i < $count; $i++) {
            // loop all available roles, see if they're configured and if so, get the associated field from the transaction.
            // some roles can be configured multiple times, so the $current array may hold multiple values.
            // the final response to this may be to join these fields or only use the last one.
            $current = [];
            foreach ($fieldNames as $field) {
                $role = $allRoles[$field] ?? '_ignore';
                if ('_ignore' !== $role) {
                    app('log')->debug(sprintf('Field "%s" was given role "%s".', $field, $role));
                }
                if ('_ignore' === $role) {
                    app('log')->debug(sprintf('Field "%s" is ignored!', $field));
                }
                // get by index, so grab it from the appropriate split or get the first one.
                $value = trim($transaction->getFieldByIndex($field, $i));
                if ('' !== $value) {
                    $current[$role] = $current[$role] ?? [
                        'data'    => [],
                        'mapping' => [],
                    ];
                    if (array_key_exists($field, $mapping)) {
                        $current[$role]['mapping'] = array_merge($mapping[$field], $current[$role]['mapping']);
                    }
                    $current[$role]['data'][] = $value;
                    $current[$role]['data']   = array_unique($current[$role]['data']);
                }
            }
            $result['transactions'][] = $current;
        }

        return $result;
    }

    private function getConfiguredRoles(): array
    {
        return array_unique(array_values($this->configuration->getRoles()));
    }

}