Skip to content

Firefly III: a personal finances manager

14.0 KB
Raw Blame
<?php

/**
 * Preferences.php
 * Copyright (c) 2019 [email protected]
 *
 * This file is part of Firefly III (https://github.com/firefly-iii).
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as
 * published by the Free Software Foundation, either version 3 of the
 * License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
declare(strict_types=1);

namespace FireflyIII\Support;

use FireflyIII\Exceptions\FireflyException;
use FireflyIII\Models\Preference;
use FireflyIII\Support\Singleton\PreferencesSingleton;
use FireflyIII\User;
use Illuminate\Contracts\Encryption\DecryptException;
use Illuminate\Contracts\Encryption\EncryptException;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Facades\Log;
use Illuminate\Support\Facades\Session;

/**
 * Class Preferences.
 */
class Preferences
{
    public function all(): Collection
    {
        $user = auth()->user();
        if (null === $user) {
            return new Collection();
        }

        return Preference::query()
            ->where('user_id', $user->id)
            ->where('name', '!=', 'currencyPreference')
            ->where(static function (Builder $q) use ($user): void {
                $q->whereNull('user_group_id');
                $q->orWhere('user_group_id', $user->user_group_id);
            })
            ->get()
        ;
    }

    public function beginsWith(User $user, string $search): Collection
    {
        $value = sprintf('%s%%', $search);

        return Preference::query()->where('user_id', $user->id)->whereLike('name', $value)->get();
    }

    public function delete(string $name, bool $overrule = false): bool
    {
        $systemPreferences = config('firefly.system_preference_keys');
        if (
            false === $overrule
            && (in_array($name, $systemPreferences, true) || array_any($systemPreferences, fn (string $arrayValue) => str_starts_with($name, $arrayValue)))
        ) {
            throw new FireflyException(sprintf('Function delete() cannot be used to delete preference "%s"', $name));
        }
        $fullName          = sprintf('preference%s%s', auth()->user()->id, $name);
        if (Cache::has($fullName)) {
            Cache::forget($fullName);
        }
        Preference::query()->where('user_id', auth()->user()->id)->where('name', $name)->delete();

        return true;
    }

    public function deleteForUser(User $user, string $name, bool $overrule = false): bool
    {
        $systemPreferences = config('firefly.system_preference_keys');
        if (
            false === $overrule
            && (in_array($name, $systemPreferences, true) || array_any($systemPreferences, fn (string $arrayValue) => str_starts_with($name, $arrayValue)))
        ) {
            throw new FireflyException(sprintf('Function deleteForUser() cannot be used to delete preference "%s"', $name));
        }
        $fullName          = sprintf('preference%s%s', $user->id, $name);
        if (Cache::has($fullName)) {
            Cache::forget($fullName);
        }
        Preference::query()->where('user_id', $user->id)->where('name', $name)->delete();

        return true;
    }

    /**
     * Find by name, has no user ID in it, because the method is called from an unauthenticated route any way.
     */
    public function findByName(string $name): Collection
    {
        return Preference::query()->where('name', $name)->get();
    }

    public function forget(User $user, string $name): void
    {
        $key = sprintf('preference%s%s', $user->id, $name);
        Cache::forget($key);
        Cache::put($key, '', 5);
    }

    public function get(string $name, array|bool|int|string|null $default = null, bool $overrule = false): ?Preference
    {
        /** @var null|User $user */
        $user = auth()->user();
        if (null === $user) {
            $preference       = new Preference();
            $preference->data = $default;
            $preference->name = $name;

            return $preference;
        }

        return $this->getForUser($user, $name, $default, $overrule);
    }

    public function getArrayForUser(User $user, array $list): array
    {
        $result      = [];
        $preferences = Preference::query()
            ->where('user_id', $user->id)
            ->where(static function (Builder $q) use ($user): void {
                $q->whereNull('user_group_id');
                $q->orWhere('user_group_id', $user->user_group_id);
            })
            ->whereIn('name', $list)
            ->get(['id', 'name', 'data'])
        ;

        /** @var Preference $preference */
        foreach ($preferences as $preference) {
            $result[$preference->name] = $preference->data;
        }
        foreach ($list as $name) {
            if (!array_key_exists($name, $result)) {
                $result[$name] = null;
            }
        }

        return $result;
    }

    public function getEncrypted(string $name, mixed $default = null): ?Preference
    {
        $result = $this->get($name, $default);
        if (!$result instanceof Preference) {
            return null;
        }
        if ('' === $result->data) {
            // Log::warning(sprintf('Empty encrypted preference found: "%s"', $name));

            return $result;
        }

        try {
            $result->data = decrypt($result->data);
        } catch (DecryptException $e) {
            if ('The MAC is invalid.' === $e->getMessage()) {
                Log::debug('Set data to NULL');
                $result->data = null;
            }
            // Log::error(sprintf('Could not decrypt preference "%s": %s', $name, $e->getMessage()));

            return $result;
        }

        return $result;
    }

    public function getEncryptedForUser(User $user, string $name, array|bool|int|string|null $default = null): ?Preference
    {
        $result = $this->getForUser($user, $name, $default);
        if ('' === $result->data) {
            // Log::warning(sprintf('Empty encrypted preference found: "%s"', $name));

            return $result;
        }

        try {
            $result->data = decrypt($result->data);
        } catch (DecryptException $e) {
            if ('The MAC is invalid.' === $e->getMessage()) {
                Log::debug('Set data to NULL');
                $result->data = null;
            }
            // Log::error(sprintf('Could not decrypt preference "%s": %s', $name, $e->getMessage()));

            return $result;
        }

        return $result;
    }

    public function getForUser(User $user, string $name, array|bool|int|string|null $default = null, bool $overrule = false): ?Preference
    {
        // Log::debug(sprintf('getForUser(#%d, "%s")', $user->id, $name));
        // don't care about user group ID, except for some specific preferences.
        $userGroupId = $this->getUserGroupId($user, $name);
        $query       = Preference::query()->where('user_id', $user->id)->where('name', $name);
        if (null !== $userGroupId) {
            Log::debug('Include user group ID in query');
            $query->where('user_group_id', $userGroupId);
        }

        $preference  = $query->first(['id', 'user_id', 'user_group_id', 'name', 'data', 'updated_at', 'created_at']);

        if (null !== $preference && null === $preference->data) {
            $preference->delete();
            $preference = null;
            Log::debug('Removed empty preference.');
        }

        if (null !== $preference) {
            // Log::debug(sprintf('Found preference #%d for user #%d: %s', $preference->id, $user->id, $name));

            return $preference;
        }
        // no preference found and default is null:
        if (null === $default) {
            Log::debug('Return NULL, create no preference.');

            // return NULL
            return null;
        }

        return $this->setForUser($user, $name, $default, $overrule);
    }

    public function getFresh(string $name, array|bool|int|string|null $default = null): ?Preference
    {
        /** @var null|User $user */
        $user = auth()->user();
        if (null === $user) {
            $preference       = new Preference();
            $preference->data = $default;

            return $preference;
        }

        return $this->getForUser($user, $name, $default, false);
    }

    public function lastActivity(): string
    {
        $instance     = PreferencesSingleton::getInstance();
        $pref         = $instance->getPreference('last_activity');
        if (null !== $pref) {
            // Log::debug(sprintf('Found last activity in singleton: %s', $pref));
            return $pref;
        }
        $lastActivity = microtime();
        $preference   = $this->get('lastActivity', microtime());

        if ($preference instanceof Preference && null !== $preference->data) {
            $lastActivity = $preference->data;
        }
        if (is_array($lastActivity)) {
            $lastActivity = implode(',', $lastActivity);
        }
        $setting      = hash('sha256', (string) $lastActivity);
        $instance->setPreference('last_activity', $setting);

        return $setting;
    }

    public function mark(): void
    {
        $this->set('lastActivity', microtime());
        $instance = PreferencesSingleton::getInstance();
        $instance->setPreference('last_activity', microtime());
        Session::forget('first');
    }

    public function set(string $name, array|bool|int|string|null $value, bool $overrule = false): Preference
    {
        $systemPreferences = config('firefly.system_preference_keys');
        if (
            false === $overrule
            && (in_array($name, $systemPreferences, true) || array_any($systemPreferences, fn (string $arrayValue) => str_starts_with($name, $arrayValue)))
        ) {
            throw new FireflyException(sprintf('Function set() cannot be used to set preference "%s"', $name));
        }

        /** @var null|User $user */
        $user              = auth()->user();
        if (null === $user) {
            // make new preference, return it:
            $pref       = new Preference();
            $pref->name = $name;
            $pref->data = $value;

            return $pref;
        }

        return $this->setForUser($user, $name, $value, $overrule);
    }

    public function setEncrypted(string $name, mixed $value, bool $overrule = false): Preference
    {
        $systemPreferences = config('firefly.system_preference_keys');
        if (
            false === $overrule
            && (in_array($name, $systemPreferences, true) || array_any($systemPreferences, fn (string $arrayValue) => str_starts_with($name, $arrayValue)))
        ) {
            throw new FireflyException(sprintf('Function setEncrypted() cannot be used to set preference "%s"', $name));
        }

        try {
            $encrypted = encrypt($value);
        } catch (EncryptException $e) {
            Log::error(sprintf('Could not encrypt preference "%s": %s', $name, $e->getMessage()));

            throw new FireflyException(sprintf('Could not encrypt preference "%s". Cowardly refuse to continue.', $name));
        }

        return $this->set($name, $encrypted, $overrule);
    }

    public function setForUser(User $user, string $name, array|bool|int|string|null $value, bool $overrule = false): Preference
    {
        $systemPreferences = config('firefly.system_preference_keys');
        if (
            false === $overrule
            && (in_array($name, $systemPreferences, true) || array_any($systemPreferences, fn (string $arrayValue) => str_starts_with($name, $arrayValue)))
        ) {
            throw new FireflyException(sprintf('Function setForUser() cannot be used to set preference "%s"', $name));
        }
        $fullName          = sprintf('preference%s%s', $user->id, $name);
        $userGroupId       = $this->getUserGroupId($user, $name);
        $userGroupId       = 0 === (int) $userGroupId ? null : (int) $userGroupId;

        Cache::forget($fullName);

        $query             = Preference::query()->where('user_id', $user->id)->where('name', $name);
        if (null !== $userGroupId) {
            Log::debug('Include user group ID in query');
            $query->where('user_group_id', $userGroupId);
        }

        $preference        = $query->first(['id', 'user_id', 'user_group_id', 'name', 'data', 'updated_at', 'created_at']);

        if (null !== $preference && null === $value) {
            $preference->delete();
            $new             = new Preference();
            $new->created_at = now();
            $new->updated_at = now();
            $new->name       = $name;
            $new->value      = null;

            return $new;
        }
        if (null === $value) {
            $new             = new Preference();
            $new->created_at = now();
            $new->updated_at = now();
            $new->name       = $name;
            $new->value      = null;

            return $new;
        }
        if (null === $preference) {
            $preference                = new Preference();
            $preference->user_id       = (int) $user->id;
            $preference->user_group_id = $userGroupId;
            $preference->name          = $name;
        }
        $preference->data  = $value;
        $preference->save();
        Cache::forever($fullName, $preference);

        return $preference;
    }

    private function getUserGroupId(User $user, string $preferenceName): ?int
    {
        $groupId = null;
        $items   = config('firefly.admin_specific_prefs') ?? [];
        if (in_array($preferenceName, $items, true)) {
            return (int) $user->user_group_id;
        }

        return $groupId;
    }
}