Merge pull request #11201 from firefly-iii/release-1762675915

🤖 Automatically merge the PR into the develop branch.
This commit is contained in:
github-actions[bot]
2025-11-09 09:12:04 +01:00
committed by GitHub
78 changed files with 183 additions and 179 deletions

View File

@@ -651,6 +651,7 @@ class BasicController extends Controller
if ($start->greaterThanOrEqualTo($date) && $end->greaterThanOrEqualTo($date)) {
return true;
}
// start and end in the past? use $end
return $start->lessThanOrEqualTo($date) && $end->lessThanOrEqualTo($date);
}

View File

@@ -251,6 +251,7 @@ class CorrectsUnevenAmount extends Command
/** @var Transaction $source */
$source = $journal->transactions()->where('amount', '<', 0)->first();
// safety catch on NULL should not be necessary, we just had that catch.
// source amount = dest foreign amount
// source currency = dest foreign currency

View File

@@ -136,6 +136,7 @@ class UpgradesLiabilitiesEight extends Command
if (null === $liabilityJournal) {
return false;
}
return (bool) $openingJournal->date->isSameDay($liabilityJournal->date);
}

View File

@@ -42,9 +42,7 @@ class ReportHelper implements ReportHelperInterface
public function __construct(
/** @var BudgetRepositoryInterface The budget repository */
protected BudgetRepositoryInterface $budgetRepository
)
{
}
) {}
/**
* This method generates a full report for the given period on all

View File

@@ -66,7 +66,7 @@ class DeleteController extends Controller
*
* @return Factory|Redirector|RedirectResponse|View
*/
public function delete(Account $account): Redirector|RedirectResponse|Factory|\Illuminate\Contracts\View\View
public function delete(Account $account): Factory|\Illuminate\Contracts\View\View|Redirector|RedirectResponse
{
if (!$this->isEditableAccount($account)) {
return $this->redirectAccountToAccount($account);

View File

@@ -76,7 +76,7 @@ class EditController extends Controller
*
* @return Factory|Redirector|RedirectResponse|View
*/
public function edit(Request $request, Account $account, AccountRepositoryInterface $repository): Redirector|RedirectResponse|Factory|\Illuminate\Contracts\View\View
public function edit(Request $request, Account $account, AccountRepositoryInterface $repository): Factory|\Illuminate\Contracts\View\View|Redirector|RedirectResponse
{
if (!$this->isEditableAccount($account)) {
return $this->redirectAccountToAccount($account);

View File

@@ -78,7 +78,7 @@ class ReconcileController extends Controller
*
* @throws FireflyException
* */
public function reconcile(Account $account, ?Carbon $start = null, ?Carbon $end = null): Redirector|RedirectResponse|Factory|\Illuminate\Contracts\View\View
public function reconcile(Account $account, ?Carbon $start = null, ?Carbon $end = null): Factory|\Illuminate\Contracts\View\View|Redirector|RedirectResponse
{
if (!$this->isEditableAccount($account)) {
return $this->redirectAccountToAccount($account);
@@ -146,7 +146,6 @@ class ReconcileController extends Controller
/**
* Submit a new reconciliation.
*
*
* @throws DuplicateTransactionException
*/
public function submit(ReconciliationStoreRequest $request, Account $account, Carbon $start, Carbon $end): Redirector|RedirectResponse

View File

@@ -84,7 +84,7 @@ class ShowController extends Controller
* @throws FireflyException
* @throws NotFoundExceptionInterface
*/
public function show(Request $request, Account $account, ?Carbon $start = null, ?Carbon $end = null): Redirector|RedirectResponse|Factory|\Illuminate\Contracts\View\View
public function show(Request $request, Account $account, ?Carbon $start = null, ?Carbon $end = null): Factory|\Illuminate\Contracts\View\View|Redirector|RedirectResponse
{
if (0 === $account->id) {
throw new NotFoundHttpException();
@@ -187,7 +187,7 @@ class ShowController extends Controller
* @throws ContainerExceptionInterface
* @throws NotFoundExceptionInterface
*/
public function showAll(Request $request, Account $account): Redirector|RedirectResponse|Factory|\Illuminate\Contracts\View\View
public function showAll(Request $request, Account $account): Factory|\Illuminate\Contracts\View\View|Redirector|RedirectResponse
{
if (!$this->isEditableAccount($account)) {
return $this->redirectAccountToAccount($account);

View File

@@ -86,7 +86,7 @@ class LinkController extends Controller
*
* @return Factory|Redirector|RedirectResponse|View
*/
public function delete(Request $request, LinkType $linkType): Redirector|RedirectResponse|Factory|\Illuminate\Contracts\View\View
public function delete(Request $request, LinkType $linkType): Factory|\Illuminate\Contracts\View\View|Redirector|RedirectResponse
{
if (false === $linkType->editable) {
$request->session()->flash('error', (string) trans('firefly.cannot_edit_link_type', ['name' => e($linkType->name)]));
@@ -135,7 +135,7 @@ class LinkController extends Controller
*
* @return Factory|Redirector|RedirectResponse|View
*/
public function edit(Request $request, LinkType $linkType): Redirector|RedirectResponse|Factory|\Illuminate\Contracts\View\View
public function edit(Request $request, LinkType $linkType): Factory|\Illuminate\Contracts\View\View|Redirector|RedirectResponse
{
if (false === $linkType->editable) {
$request->session()->flash('error', (string) trans('firefly.cannot_edit_link_type', ['name' => e($linkType->name)]));

View File

@@ -73,7 +73,7 @@ class UserController extends Controller
/**
* @return Application|Factory|Redirector|RedirectResponse|View
*/
public function delete(User $user): Redirector|RedirectResponse|Factory|\Illuminate\Contracts\View\View
public function delete(User $user): Factory|\Illuminate\Contracts\View\View|Redirector|RedirectResponse
{
if ($this->externalIdentity) {
request()->session()->flash('error', trans('firefly.external_user_mgt_disabled'));

View File

@@ -222,7 +222,7 @@ class LoginController extends Controller
* @throws ContainerExceptionInterface
* @throws NotFoundExceptionInterface
*/
public function showLoginForm(Request $request): Redirector|RedirectResponse|Factory|View
public function showLoginForm(Request $request): Factory|Redirector|RedirectResponse|View
{
Log::channel('audit')->info('Show login form (1.1).');

View File

@@ -114,6 +114,7 @@ class ResetPasswordController extends Controller
*
* If no token is present, display the link request form.
*
* @param null|mixed $token
*
* @return Factory|View
*

View File

@@ -59,7 +59,6 @@ class TwoFactorController extends Controller
}
/**
*
* @throws ContainerExceptionInterface
* @throws NotFoundExceptionInterface
*/
@@ -211,6 +210,7 @@ class TwoFactorController extends Controller
if (!is_array($list)) {
$list = [];
}
return in_array($mfaCode, $list, true);
}

View File

@@ -96,7 +96,6 @@ class DebugController extends Controller
/**
* Clear log and session.
*
*
* @throws FireflyException
*/
public function flush(Request $request): Redirector|RedirectResponse
@@ -514,30 +513,40 @@ class DebugController extends Controller
case 'userGroup':
return '1';
case 'start_date':
case 'date':
return '20241201';
case 'end_date':
return '20241231';
case 'fromCurrencyCode':
return 'EUR';
case 'toCurrencyCode':
return 'USD';
case 'accountList':
return '1,6';
case 'budgetList':
case 'categoryList':
case 'doubleList':
case 'tagList':
case 'journalList':
return '1,2';
case 'route':
return 'accounts';
case 'specificPage':
return 'show';
case 'reportType':
return 'default';
case 'transactionType':
return 'withdrawal';

View File

@@ -64,7 +64,7 @@ class NewUserController extends Controller
*
* @return Factory|Redirector|RedirectResponse|View
*/
public function index(): Redirector|RedirectResponse|Factory|\Illuminate\Contracts\View\View
public function index(): Factory|\Illuminate\Contracts\View\View|Redirector|RedirectResponse
{
app('view')->share('title', (string) trans('firefly.welcome'));
app('view')->share('mainTitleIcon', 'fa-fire');

View File

@@ -188,7 +188,6 @@ class PreferencesController extends Controller
/**
* Store new preferences.
*
*
* @throws FireflyException
*
* @SuppressWarnings("PHPMD.ExcessiveMethodLength")

View File

@@ -228,7 +228,6 @@ class MfaController extends Controller
/**
* Submit 2FA for the first time.
*
*
* @throws ContainerExceptionInterface
* @throws NotFoundExceptionInterface
*/

View File

@@ -288,7 +288,7 @@ class ProfileController extends Controller
*
* @return Factory|Redirector|RedirectResponse|View
*/
public function changePassword(Request $request): Redirector|RedirectResponse|Factory|\Illuminate\Contracts\View\View
public function changePassword(Request $request): Factory|\Illuminate\Contracts\View\View|Redirector|RedirectResponse
{
if (!$this->internalAuth) {
$request->session()->flash('error', trans('firefly.external_user_mgt_disabled'));
@@ -361,7 +361,6 @@ class ProfileController extends Controller
/**
* Regenerate access token.
*
*
* @throws Exception
*/
public function regenerate(Request $request): Redirector|RedirectResponse
@@ -384,7 +383,6 @@ class ProfileController extends Controller
/**
* Undo change of user email address.
*
*
* @throws FireflyException
*/
public function undoEmailChange(UserRepositoryInterface $repository, string $token, string $hash): Redirector|RedirectResponse

View File

@@ -193,7 +193,6 @@ class ReportController extends Controller
/**
* Show account report.
*
*
* @throws FireflyException
*/
public function doubleReport(Collection $accounts, Collection $expense, Carbon $start, Carbon $end): string

View File

@@ -37,7 +37,7 @@ class CronController
/**
* @return Application|Response|ResponseFactory
*/
public function cron(): ResponseFactory|Response
public function cron(): Response|ResponseFactory
{
Log::error('The cron endpoint has moved to GET /api/v1/cron/[token]');

View File

@@ -87,7 +87,7 @@ class ConvertController extends Controller
*
* @throws Exception
*/
public function index(TransactionType $destinationType, TransactionGroup $group): Redirector|RedirectResponse|Factory|\Illuminate\Contracts\View\View
public function index(TransactionType $destinationType, TransactionGroup $group): Factory|\Illuminate\Contracts\View\View|Redirector|RedirectResponse
{
if (!$this->isEditableGroup($group)) {
return $this->redirectGroupToAccount($group);

View File

@@ -100,7 +100,6 @@ class CreateController extends Controller
/**
* Create a new transaction group.
*
*
* @throws ContainerExceptionInterface
* @throws NotFoundExceptionInterface
* @throws UrlException

View File

@@ -68,7 +68,7 @@ class DeleteController extends Controller
/**
* Shows the form that allows a user to delete a transaction journal.
*/
public function delete(TransactionGroup $group): Redirector|RedirectResponse|Factory|View
public function delete(TransactionGroup $group): Factory|Redirector|RedirectResponse|View
{
if (!$this->isEditableGroup($group)) {
return $this->redirectGroupToAccount($group);

View File

@@ -74,7 +74,7 @@ class EditController extends Controller
* @throws NotFoundExceptionInterface
* @throws UrlException
*/
public function edit(TransactionGroup $transactionGroup): Redirector|RedirectResponse|Factory|\Illuminate\Contracts\View\View
public function edit(TransactionGroup $transactionGroup): Factory|\Illuminate\Contracts\View\View|Redirector|RedirectResponse
{
app('preferences')->mark();

View File

@@ -154,7 +154,6 @@ class MassController extends Controller
/**
* Mass update of journals.
*
*
* @throws FireflyException
*/
public function update(MassEditJournalRequest $request): Redirector|RedirectResponse

View File

@@ -70,7 +70,7 @@ class CreateController extends Controller
*
* @return Factory|Redirector|RedirectResponse|View
*/
public function create(Request $request): Redirector|RedirectResponse|Factory|\Illuminate\Contracts\View\View
public function create(Request $request): Factory|\Illuminate\Contracts\View\View|Redirector|RedirectResponse
{
/** @var User $user */
$user = auth()->user();

View File

@@ -71,7 +71,7 @@ class DeleteController extends Controller
*
* @throws FireflyException
*/
public function delete(Request $request, TransactionCurrency $currency): Redirector|RedirectResponse|Factory|\Illuminate\Contracts\View\View
public function delete(Request $request, TransactionCurrency $currency): Factory|\Illuminate\Contracts\View\View|Redirector|RedirectResponse
{
/** @var User $user */
$user = auth()->user();
@@ -102,7 +102,6 @@ class DeleteController extends Controller
/**
* Destroys a currency.
*
*
* @throws FireflyException
*/
public function destroy(Request $request, TransactionCurrency $currency): Redirector|RedirectResponse

View File

@@ -67,7 +67,7 @@ class EditController extends Controller
*
* @return Factory|Redirector|RedirectResponse|View
*/
public function edit(Request $request, TransactionCurrency $currency): Redirector|RedirectResponse|Factory|\Illuminate\Contracts\View\View
public function edit(Request $request, TransactionCurrency $currency): Factory|\Illuminate\Contracts\View\View|Redirector|RedirectResponse
{
/** @var User $user */
$user = auth()->user();
@@ -107,7 +107,6 @@ class EditController extends Controller
/**
* Updates a currency.
*
*
* @throws FireflyException
*/
public function update(CurrencyFormRequest $request, TransactionCurrency $currency): Redirector|RedirectResponse

View File

@@ -139,6 +139,7 @@ class Authenticate
app('session')->flash('logoutMessage', $message);
// @noinspection PhpUndefinedMethodInspection
$this->auth->logout();
// @phpstan-ignore-line (thinks function is undefined)
throw new AuthenticationException('Blocked account.', $guards);
}

View File

@@ -45,8 +45,8 @@ class Binder
public function __construct(/**
* The authentication factory instance.
*/
protected Auth $auth)
{
protected Auth $auth
) {
$this->binders = Domain::getBindables();
}

View File

@@ -127,6 +127,7 @@ class WarnAboutBills implements ShouldQueue
$diff = $this->getDiff($bill, $field);
$list = config('firefly.bill_reminder_periods');
Log::debug(sprintf('Difference in days for field "%s" ("%s") is %d day(s)', $field, $bill->{$field}->format('Y-m-d'), $diff));
return in_array($diff, $list, true);
}
@@ -189,6 +190,7 @@ class WarnAboutBills implements ShouldQueue
Log::debug(sprintf('Earliest expected pay date is %s', $earliest->toAtomString()));
$diff = $earliest->diffInDays($this->date);
Log::debug(sprintf('Difference in days is %s', $diff));
return $diff >= 2;
}

View File

@@ -79,6 +79,7 @@ class AppServiceProvider extends ServiceProvider
$params = Route::getCurrentRoute()->parameters();
$params ??= [];
$objectType = $params['objectType'] ?? '';
return $objectType === $firstParam && str_contains($name, $route);
});
}

View File

@@ -77,8 +77,7 @@ class JournalRepository implements JournalRepositoryInterface, UserGroupInterfac
public function firstNull(): ?TransactionJournal
{
/** @var null|TransactionJournal $entry */
$entry = $this->user->transactionJournals()->orderBy('date', 'ASC')->first(['transaction_journals.*']);
return $entry;
return $this->user->transactionJournals()->orderBy('date', 'ASC')->first(['transaction_journals.*']);
}
public function getDestinationAccount(TransactionJournal $journal): Account
@@ -115,8 +114,7 @@ class JournalRepository implements JournalRepositoryInterface, UserGroupInterfac
public function getLast(): ?TransactionJournal
{
/** @var null|TransactionJournal $entry */
$entry = $this->user->transactionJournals()->orderBy('date', 'DESC')->first(['transaction_journals.*']);
return $entry;
return $this->user->transactionJournals()->orderBy('date', 'DESC')->first(['transaction_journals.*']);
}
public function getLinkNoteText(TransactionJournalLink $link): string

View File

@@ -38,9 +38,7 @@ class IsAllowedGroupAction implements ValidationRule
// you need these roles to do anything with any endpoint.
private array $acceptedRoles = [UserRoleEnum::OWNER, UserRoleEnum::FULL];
public function __construct(private readonly string $className, private readonly string $methodName)
{
}
public function __construct(private readonly string $className, private readonly string $methodName) {}
/**
* @throws AuthorizationException
@@ -74,6 +72,7 @@ class IsAllowedGroupAction implements ValidationRule
} catch (FireflyException $e) {
Log::error($e->getTraceAsString());
}
exit('here we are');
}
}

View File

@@ -78,6 +78,7 @@ trait AccountServiceTrait
// not set, so false.
return false;
}
// if is set, but is empty:
return (array_key_exists('opening_balance', $data) && '' === $data['opening_balance'])
|| (array_key_exists('opening_balance_date', $data) && '' === $data['opening_balance_date']);

View File

@@ -105,6 +105,7 @@ class GroupUpdateService
$result = array_diff($existing, $updated);
Log::debug('Result of DIFF: ', $result);
/** @var string $deletedId */
foreach ($result as $deletedId) {
/** @var TransactionJournal $journal */

View File

@@ -31,7 +31,6 @@ use Illuminate\Contracts\Auth\Authenticatable;
use Illuminate\Contracts\Auth\Guard;
use Illuminate\Contracts\Auth\UserProvider;
use Illuminate\Contracts\Foundation\Application;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Log;
/**

View File

@@ -225,6 +225,8 @@ class ExpandedForm
}
/**
* @param null|mixed $value
*
* @throws FireflyException
*/
public function objectGroup($value = null, ?array $options = null): string

View File

@@ -132,6 +132,7 @@ trait RequestInformation
if ($start->greaterThanOrEqualTo($date) && $end->greaterThanOrEqualTo($date)) {
return true;
}
// start and end in the past? use $end
return $start->lessThanOrEqualTo($date) && $end->lessThanOrEqualTo($date);
}

View File

@@ -86,9 +86,7 @@ class BudgetLimitEnrichment implements EnrichmentInterface
$this->user = $user;
}
public function setUserGroup(UserGroup $userGroup): void
{
}
public function setUserGroup(UserGroup $userGroup): void {}
private function appendCollectedData(): void
{

View File

@@ -90,9 +90,7 @@ class PiggyBankEnrichment implements EnrichmentInterface
$this->setUserGroup($user->userGroup);
}
public function setUserGroup(UserGroup $userGroup): void
{
}
public function setUserGroup(UserGroup $userGroup): void {}
private function appendCollectedData(): void
{

View File

@@ -78,9 +78,7 @@ class PiggyBankEventEnrichment implements EnrichmentInterface
$this->setUserGroup($user->userGroup);
}
public function setUserGroup(UserGroup $userGroup): void
{
}
public function setUserGroup(UserGroup $userGroup): void {}
private function appendCollectedData(): void
{

View File

@@ -166,9 +166,7 @@ class SubscriptionEnrichment implements EnrichmentInterface
$this->user = $user;
}
public function setUserGroup(UserGroup $userGroup): void
{
}
public function setUserGroup(UserGroup $userGroup): void {}
/**
* Returns the latest date in the set, or start when set is empty.

View File

@@ -94,13 +94,9 @@ class TransactionGroupEnrichment implements EnrichmentInterface
throw new FireflyException('Cannot enrich single model.');
}
public function setUser(User $user): void
{
}
public function setUser(User $user): void {}
public function setUserGroup(UserGroup $userGroup): void
{
}
public function setUserGroup(UserGroup $userGroup): void {}
private function appendCollectedData(): void
{

View File

@@ -73,13 +73,9 @@ class WebhookEnrichment implements EnrichmentInterface
return $collection->first();
}
public function setUser(User $user): void
{
}
public function setUser(User $user): void {}
public function setUserGroup(UserGroup $userGroup): void
{
}
public function setUserGroup(UserGroup $userGroup): void {}
private function appendCollectedInfo(): void
{

View File

@@ -64,6 +64,7 @@ class ParseDateString
if ('xxxx-xx-xx' === strtolower($date)) {
return false;
}
// no x'es
return !(!str_contains($date, 'xx') && !str_contains($date, 'xxxx'));
}

View File

@@ -52,8 +52,10 @@ trait AppendsLocationData
* Abstract method stolen from "InteractsWithInput".
*
* @param bool $default
* @param null|mixed $key
*
* @return mixed
*
* @SuppressWarnings("PHPMD.BooleanArgumentFlag")
*/
abstract public function boolean($key = null, $default = false);

View File

@@ -274,6 +274,7 @@ trait ConvertsDataTypes
if ('y' === $value) {
return true;
}
return '1' === $value;
}

View File

@@ -74,6 +74,7 @@ class OAuthKeys
Log::error($e->getTraceAsString());
}
}
return '' !== $privateKey && '' !== $publicKey;
}

View File

@@ -292,6 +292,7 @@ class General extends AbstractExtension
'hasRole',
static function (string $role): bool {
$repository = app(UserRepositoryInterface::class);
return $repository->hasRole(auth()->user(), $role);
}
);

View File

@@ -81,7 +81,7 @@ class TransactionGroupTwig extends AbstractExtension
{
return new TwigFunction(
'journalGetMetaDate',
static function (int $journalId, string $metaField): CarbonInterface|Carbon {
static function (int $journalId, string $metaField): Carbon|CarbonInterface {
/** @var null|TransactionJournalMeta $entry */
$entry = DB::table('journal_meta')
->where('name', $metaField)

View File

@@ -59,7 +59,7 @@ class Translation extends AbstractExtension
{
return new TwigFunction(
'journalLinkTranslation',
static function (string $direction, string $original): string|Translator|array {
static function (string $direction, string $original): array|string|Translator {
$key = sprintf('firefly.%s_%s', $original, $direction);
$translation = trans($key);
if ($key === $translation) {
@@ -76,7 +76,7 @@ class Translation extends AbstractExtension
{
return new TwigFunction(
'__',
static function (string $key): string|Translator|array {
static function (string $key): array|string|Translator {
$translation = trans($key);
if ($key === $translation) {
return $key;

View File

@@ -259,6 +259,7 @@ class TransactionGroupTransformer extends AbstractTransformer
return (string) $array[$key];
}
return $default;
}

View File

@@ -230,6 +230,7 @@ class AccountValidator
protected function canCreateType(string $accountType): bool
{
$canCreate = [AccountTypeEnum::EXPENSE->value, AccountTypeEnum::REVENUE->value, AccountTypeEnum::INITIAL_BALANCE->value, AccountTypeEnum::LIABILITY_CREDIT->value];
return in_array($accountType, $canCreate, true);
}

View File

@@ -123,6 +123,7 @@ class FireflyValidator extends Validator
}
$regex = '/^[a-z]{6}[0-9a-z]{2}([0-9a-z]{3})?\z/i';
$result = preg_match($regex, $value);
return 0 !== $result;
}

View File

@@ -302,6 +302,7 @@ trait TransactionValidation
private function isLiability(Account $account): bool
{
$type = $account->accountType->type;
return in_array($type, config('firefly.valid_liabilities'), true);
}
@@ -323,6 +324,7 @@ trait TransactionValidation
if ('' === $transaction['foreign_amount']) {
return false;
}
return 0 !== bccomp('0', (string) $transaction['foreign_amount']);
}
@@ -750,6 +752,7 @@ trait TransactionValidation
// source ID's are equal, return void.
return true;
}
// source names are equal, return void.
return (bool) $this->arrayEqual($comparison['source_name']);
}
@@ -765,6 +768,7 @@ trait TransactionValidation
// destination ID's are equal, return void.
return true;
}
// destination names are equal, return void.
return (bool) $this->arrayEqual($comparison['destination_name']);
}
@@ -783,6 +787,7 @@ trait TransactionValidation
// destination ID's are equal, return void.
return true;
}
// destination names are equal, return void.
return (bool) $this->arrayEqual($comparison['destination_name']);
}

View File

@@ -78,8 +78,8 @@ return [
'running_balance_column' => env('USE_RUNNING_BALANCE', false),
// see cer.php for exchange rates feature flag.
],
'version' => '6.4.6',
'build_time' => 1762641809,
'version' => 'develop/2025-11-09',
'build_time' => 1762675805,
'api_version' => '2.1.0', // field is no longer used.
'db_version' => 28, // field is no longer used.