. */ declare(strict_types=1); namespace FireflyIII\Transformers; use FireflyIII\Exceptions\FireflyException; use FireflyIII\Models\Bill; use FireflyIII\Models\Budget; use FireflyIII\Models\Category; use FireflyIII\Models\Transaction; use FireflyIII\Models\TransactionCurrency; use FireflyIII\Models\TransactionGroup; use FireflyIII\Models\TransactionJournal; use FireflyIII\Models\TransactionType; use FireflyIII\Repositories\TransactionGroup\TransactionGroupRepositoryInterface; use FireflyIII\Support\NullArrayObject; use Illuminate\Support\Collection; use Log; /** * Class TransactionGroupTransformer */ class TransactionGroupTransformer extends AbstractTransformer { private TransactionGroupRepositoryInterface $groupRepos; private array $metaDateFields; private array $metaFields; /** * Constructor. * * @codeCoverageIgnore */ public function __construct() { $this->groupRepos = app(TransactionGroupRepositoryInterface::class); $this->metaFields = [ 'sepa_cc', 'sepa_ct_op', 'sepa_ct_id', 'sepa_db', 'sepa_country', 'sepa_ep', 'sepa_ci', 'sepa_batch_id', 'internal_reference', 'bunq_payment_id', 'import_hash_v2', 'recurrence_id', 'external_id', 'original_source', 'external_uri', 'recurrence_count', 'recurrence_total', ]; $this->metaDateFields = ['interest_date', 'book_date', 'process_date', 'due_date', 'payment_date', 'invoice_date']; } /** * @param array $group * * @return array */ public function transform(array $group): array { $data = new NullArrayObject($group); $first = new NullArrayObject(reset($group['transactions'])); return [ 'id' => (int) $first['transaction_group_id'], 'created_at' => $first['created_at']->toAtomString(), 'updated_at' => $first['updated_at']->toAtomString(), 'user' => (int) $data['user_id'], 'group_title' => $data['title'], 'transactions' => $this->transformTransactions($data), 'links' => [ [ 'rel' => 'self', 'uri' => '/transactions/' . $first['transaction_group_id'], ], ], ]; } /** * @param TransactionGroup $group * * @return array * @throws FireflyException */ public function transformObject(TransactionGroup $group): array { try { $result = [ 'id' => (int) $group->id, 'created_at' => $group->created_at->toAtomString(), 'updated_at' => $group->updated_at->toAtomString(), 'user' => (int) $group->user_id, 'group_title' => $group->title, 'transactions' => $this->transformJournals($group->transactionJournals), 'links' => [ [ 'rel' => 'self', 'uri' => '/transactions/' . $group->id, ], ], ]; } catch (FireflyException $e) { Log::error($e->getMessage()); Log::error($e->getTraceAsString()); throw new FireflyException(sprintf('Transaction group #%d is broken. Please check out your log files.', $group->id)); } // do something else. return $result; } /** * @param string $type * @param string $amount * * @return string */ private function getAmount(string $type, string $amount): string { $amount = app('steam')->positive($amount); if (TransactionType::WITHDRAWAL !== $type) { $amount = app('steam')->negative($amount); } return $amount; } /** * @param Bill|null $bill * * @return array */ private function getBill(?Bill $bill): array { $array = [ 'id' => null, 'name' => null, ]; if (null === $bill) { return $array; } $array['id'] = (int) $bill->id; $array['name'] = $bill->name; return $array; } /** * @param Budget|null $budget * * @return array */ private function getBudget(?Budget $budget): array { $array = [ 'id' => null, 'name' => null, ]; if (null === $budget) { return $array; } $array['id'] = (int) $budget->id; $array['name'] = $budget->name; return $array; } /** * @param Category|null $category * * @return array */ private function getCategory(?Category $category): array { $array = [ 'id' => null, 'name' => null, ]; if (null === $category) { return $array; } $array['id'] = (int) $category->id; $array['name'] = $category->name; return $array; } /** * @param NullArrayObject $dates * * @return array */ private function getDates(NullArrayObject $dates): array { $fields = [ 'interest_date', 'book_date', 'process_date', 'due_date', 'payment_date', 'invoice_date', ]; $return = []; foreach ($fields as $field) { $return[$field] = null; if (null !== $dates[$field]) { $return[$field] = $dates[$field]->toAtomString(); } } return $return; } /** * @param TransactionJournal $journal * * @return Transaction * @throws FireflyException */ private function getDestinationTransaction(TransactionJournal $journal): Transaction { $result = $journal->transactions->first( static function (Transaction $transaction) { return (float) $transaction->amount > 0; } ); if (null === $result) { throw new FireflyException(sprintf('Journal #%d unexpectedly has no destination transaction.', $journal->id)); } return $result; } /** * @param string $type * @param string|null $foreignAmount * * @return string|null */ private function getForeignAmount(string $type, ?string $foreignAmount): ?string { $result = null; if (null !== $foreignAmount) { $result = TransactionType::WITHDRAWAL !== $type ? app('steam')->negative($foreignAmount) : app('steam')->positive($foreignAmount); } return $result; } /** * @param TransactionCurrency|null $currency * * @return array */ private function getForeignCurrency(?TransactionCurrency $currency): array { $array = [ 'id' => null, 'code' => null, 'symbol' => null, 'decimal_places' => null, ]; if (null === $currency) { return $array; } $array['id'] = (int) $currency->id; $array['code'] = $currency->code; $array['symbol'] = $currency->symbol; $array['decimal_places'] = (int) $currency->decimal_places; return $array; } /** * @param TransactionJournal $journal * * @return Transaction * @throws FireflyException */ private function getSourceTransaction(TransactionJournal $journal): Transaction { $result = $journal->transactions->first( static function (Transaction $transaction) { return (float) $transaction->amount < 0; } ); if (null === $result) { throw new FireflyException(sprintf('Journal #%d unexpectedly has no source transaction.', $journal->id)); } return $result; } /** * @param TransactionJournal $journal * * @return array * @throws FireflyException */ private function transformJournal(TransactionJournal $journal): array { $source = $this->getSourceTransaction($journal); $destination = $this->getDestinationTransaction($journal); $type = $journal->transactionType->type; $amount = $this->getAmount($type, $source->amount); $foreignAmount = $this->getForeignAmount($type, $source->foreign_amount); $metaFieldData = $this->groupRepos->getMetaFields($journal->id, $this->metaFields); $metaDates = $this->getDates($this->groupRepos->getMetaDateFields($journal->id, $this->metaDateFields)); $currency = $source->transactionCurrency; $foreignCurrency = $this->getForeignCurrency($source->foreignCurrency); $budget = $this->getBudget($journal->budgets->first()); $category = $this->getCategory($journal->categories->first()); $bill = $this->getBill($journal->bill); if (null !== $foreignAmount && null !== $foreignCurrency) { $foreignAmount = number_format((float) $foreignAmount, $foreignCurrency['decimal_places'], '.', ''); } return [ 'user' => (int) $journal->user_id, 'transaction_journal_id' => (int) $journal->id, 'type' => strtolower($type), 'date' => $journal->date->toAtomString(), 'order' => $journal->order, 'currency_id' => (int) $currency->id, 'currency_code' => $currency->code, 'currency_symbol' => $currency->symbol, 'currency_decimal_places' => (int) $currency->decimal_places, 'foreign_currency_id' => $foreignCurrency['id'], 'foreign_currency_code' => $foreignCurrency['code'], 'foreign_currency_symbol' => $foreignCurrency['symbol'], 'foreign_currency_decimal_places' => $foreignCurrency['decimal_places'], 'amount' => number_format((float) $amount, $currency->decimal_places, '.', ''), 'foreign_amount' => $foreignAmount, 'description' => $journal->description, 'source_id' => (int) $source->account_id, 'source_name' => $source->account->name, 'source_iban' => $source->account->iban, 'source_type' => $source->account->accountType->type, 'destination_id' => (int) $destination->account_id, 'destination_name' => $destination->account->name, 'destination_iban' => $destination->account->iban, 'destination_type' => $destination->account->accountType->type, 'budget_id' => $budget['id'], 'budget_name' => $budget['name'], 'category_id' => $category['id'], 'category_name' => $category['name'], 'bill_id' => $bill['id'], 'bill_name' => $bill['name'], 'reconciled' => $source->reconciled, 'notes' => $this->groupRepos->getNoteText($journal->id), 'tags' => $this->groupRepos->getTags($journal->id), 'internal_reference' => $metaFieldData['internal_reference'], 'external_id' => $metaFieldData['external_id'], 'original_source' => $metaFieldData['original_source'], 'recurrence_id' => $metaFieldData['recurrence_id'], 'bunq_payment_id' => $metaFieldData['bunq_payment_id'], 'import_hash_v2' => $metaFieldData['import_hash_v2'], 'sepa_cc' => $metaFieldData['sepa_cc'], 'sepa_ct_op' => $metaFieldData['sepa_ct_op'], 'sepa_ct_id' => $metaFieldData['sepa_ct_id'], 'sepa_db' => $metaFieldData['sepa_db'], 'sepa_country' => $metaFieldData['sepa_country'], 'sepa_ep' => $metaFieldData['sepa_ep'], 'sepa_ci' => $metaFieldData['sepa_ci'], 'sepa_batch_id' => $metaFieldData['sepa_batch_id'], 'interest_date' => $metaDates['interest_date'], 'book_date' => $metaDates['book_date'], 'process_date' => $metaDates['process_date'], 'due_date' => $metaDates['due_date'], 'payment_date' => $metaDates['payment_date'], 'invoice_date' => $metaDates['invoice_date'], ]; } /** * @param Collection $transactionJournals * * @return array * @throws FireflyException */ private function transformJournals(Collection $transactionJournals): array { $result = []; /** @var TransactionJournal $journal */ foreach ($transactionJournals as $journal) { $result[] = $this->transformJournal($journal); } return $result; } /** * @param NullArrayObject $data * * @return array */ private function transformTransactions(NullArrayObject $data): array { $result = []; $transactions = $data['transactions'] ?? []; foreach ($transactions as $transaction) { $result[] = $this->transformTransaction($transaction); } return $result; } /** * @param array $transaction * @return array */ private function transformTransaction(array $transaction): array { $row = new NullArrayObject($transaction); // amount: $type = $this->stringFromArray($transaction, 'transaction_type_type', TransactionType::WITHDRAWAL); $amount = app('steam')->positive($row['amount'] ?? '0'); $foreignAmount = null; if (null !== $row['foreign_amount']) { $foreignAmount = app('steam')->positive($row['foreign_amount']); } $metaFieldData = $this->groupRepos->getMetaFields((int) $row['transaction_journal_id'], $this->metaFields); $metaDateData = $this->groupRepos->getMetaDateFields((int) $row['transaction_journal_id'], $this->metaDateFields); return [ 'user' => (int) $row['user_id'], 'transaction_journal_id' => (int) $row['transaction_journal_id'], 'type' => strtolower($type), 'date' => $row['date']->toAtomString(), 'order' => $row['order'], 'currency_id' => (int) $row['currency_id'], 'currency_code' => $row['currency_code'], 'currency_name' => $row['currency_name'], 'currency_symbol' => $row['currency_symbol'], 'currency_decimal_places' => (int) $row['currency_decimal_places'], 'foreign_currency_id' => $this->integerFromArray($transaction, 'foreign_currency_id'), 'foreign_currency_code' => $row['foreign_currency_code'], 'foreign_currency_symbol' => $row['foreign_currency_symbol'], 'foreign_currency_decimal_places' => $row['foreign_currency_decimal_places'], 'amount' => $amount, 'foreign_amount' => $foreignAmount, 'description' => $row['description'], 'source_id' => (int) $row['source_account_id'], 'source_name' => $row['source_account_name'], 'source_iban' => $row['source_account_iban'], 'source_type' => $row['source_account_type'], 'destination_id' => (int) $row['destination_account_id'], 'destination_name' => $row['destination_account_name'], 'destination_iban' => $row['destination_account_iban'], 'destination_type' => $row['destination_account_type'], 'budget_id' => $this->integerFromArray($transaction, 'budget_id'), 'budget_name' => $row['budget_name'], 'category_id' => $this->integerFromArray($transaction, 'category_id'), 'category_name' => $row['category_name'], 'bill_id' => $this->integerFromArray($transaction, 'bill_id'), 'bill_name' => $row['bill_name'], 'reconciled' => $row['reconciled'], 'notes' => $this->groupRepos->getNoteText((int) $row['transaction_journal_id']), 'tags' => $this->groupRepos->getTags((int) $row['transaction_journal_id']), 'internal_reference' => $metaFieldData['internal_reference'], 'external_id' => $metaFieldData['external_id'], 'original_source' => $metaFieldData['original_source'], 'recurrence_id' => $this->integerFromArray($metaFieldData->getArrayCopy(), 'recurrence_id'), 'recurrence_total' => $this->integerFromArray($metaFieldData->getArrayCopy(), 'recurrence_total'), 'recurrence_count' => $this->integerFromArray($metaFieldData->getArrayCopy(), 'recurrence_count'), 'bunq_payment_id' => $metaFieldData['bunq_payment_id'], 'external_uri' => $metaFieldData['external_uri'], 'import_hash_v2' => $metaFieldData['import_hash_v2'], 'sepa_cc' => $metaFieldData['sepa_cc'], 'sepa_ct_op' => $metaFieldData['sepa_ct_op'], 'sepa_ct_id' => $metaFieldData['sepa_ct_id'], 'sepa_db' => $metaFieldData['sepa_ddb'], 'sepa_country' => $metaFieldData['sepa_country'], 'sepa_ep' => $metaFieldData['sepa_ep'], 'sepa_ci' => $metaFieldData['sepa_ci'], 'sepa_batch_id' => $metaFieldData['sepa_batch_id'], 'interest_date' => $this->dateFromArray($metaDateData, 'interest_date'), 'book_date' => $this->dateFromArray($metaDateData, 'book_date'), 'process_date' => $this->dateFromArray($metaDateData, 'process_date'), 'due_date' => $this->dateFromArray($metaDateData, 'due_date'), 'payment_date' => $this->dateFromArray($metaDateData, 'payment_date'), 'invoice_date' => $this->dateFromArray($metaDateData, 'invoice_date'), ]; } /** * @param array $array * @param string $key * @param string|null $default * @return string|null */ private function stringFromArray(array $array, string $key, ?string $default): ?string { if (array_key_exists($key, $array)) { return $array[$key]; } if (null !== $default) { return $default; } return null; } /** * @param array $array * @param string $key * @return int|null */ private function integerFromArray(array $array, string $key): ?int { if (array_key_exists($key, $array)) { return (int) $array[$key]; } return null; } /** * @param NullArrayObject $object * @param string $key * @return string|null */ private function dateFromArray(NullArrayObject $object, string $key): ?string { if (null === $object[$key]) { return null; } return $object[$key]->toAtomString(); } }