2016-01-13 11:34:56 -06:00
|
|
|
<?php
|
2022-12-29 12:42:26 -06:00
|
|
|
|
2016-01-13 11:34:56 -06:00
|
|
|
/**
|
|
|
|
* RuleRepositoryInterface.php
|
2020-02-16 07:00:57 -06:00
|
|
|
* Copyright (c) 2019 james@firefly-iii.org
|
2016-01-13 11:34:56 -06:00
|
|
|
*
|
2019-10-01 23:37:26 -05:00
|
|
|
* This file is part of Firefly III (https://github.com/firefly-iii).
|
2016-10-04 23:52:15 -05:00
|
|
|
*
|
2019-10-01 23:37:26 -05:00
|
|
|
* 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.
|
2017-10-21 01:40:00 -05:00
|
|
|
*
|
2019-10-01 23:37:26 -05:00
|
|
|
* This program is distributed in the hope that it will be useful,
|
2017-10-21 01:40:00 -05:00
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
2019-10-01 23:37:26 -05:00
|
|
|
* GNU Affero General Public License for more details.
|
2017-10-21 01:40:00 -05:00
|
|
|
*
|
2019-10-01 23:37:26 -05:00
|
|
|
* 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/>.
|
2016-01-13 11:34:56 -06:00
|
|
|
*/
|
2017-04-09 00:44:22 -05:00
|
|
|
declare(strict_types=1);
|
2016-05-20 05:41:23 -05:00
|
|
|
|
2016-01-13 11:34:56 -06:00
|
|
|
namespace FireflyIII\Repositories\Rule;
|
|
|
|
|
2016-01-14 02:38:48 -06:00
|
|
|
use FireflyIII\Models\Rule;
|
2016-01-14 14:34:17 -06:00
|
|
|
use FireflyIII\Models\RuleAction;
|
2016-01-13 11:34:56 -06:00
|
|
|
use FireflyIII\Models\RuleGroup;
|
2016-01-14 14:34:17 -06:00
|
|
|
use FireflyIII\Models\RuleTrigger;
|
2017-01-30 09:40:49 -06:00
|
|
|
use FireflyIII\User;
|
2023-02-19 01:43:28 -06:00
|
|
|
use Illuminate\Contracts\Auth\Authenticatable;
|
2018-05-05 06:53:12 -05:00
|
|
|
use Illuminate\Support\Collection;
|
2016-01-13 11:34:56 -06:00
|
|
|
|
|
|
|
/**
|
2017-11-15 05:25:49 -06:00
|
|
|
* Interface RuleRepositoryInterface.
|
2016-01-13 11:34:56 -06:00
|
|
|
*/
|
|
|
|
interface RuleRepositoryInterface
|
|
|
|
{
|
2016-04-06 02:27:45 -05:00
|
|
|
public function count(): int;
|
2016-01-24 09:50:55 -06:00
|
|
|
|
2016-04-06 02:27:45 -05:00
|
|
|
public function destroy(Rule $rule): bool;
|
2016-01-13 14:44:26 -06:00
|
|
|
|
2020-03-14 15:01:21 -05:00
|
|
|
public function duplicate(Rule $rule): Rule;
|
|
|
|
|
2018-07-22 14:09:57 -05:00
|
|
|
public function find(int $ruleId): ?Rule;
|
2017-09-03 08:57:13 -05:00
|
|
|
|
2018-06-30 09:46:51 -05:00
|
|
|
/**
|
|
|
|
* Get all the users rules.
|
|
|
|
*/
|
|
|
|
public function getAll(): Collection;
|
|
|
|
|
2016-04-06 02:27:45 -05:00
|
|
|
public function getFirstRuleGroup(): RuleGroup;
|
2016-01-24 09:50:55 -06:00
|
|
|
|
2016-04-06 02:27:45 -05:00
|
|
|
public function getHighestOrderInRuleGroup(RuleGroup $ruleGroup): int;
|
2016-01-14 14:34:17 -06:00
|
|
|
|
2016-02-17 10:27:41 -06:00
|
|
|
public function getPrimaryTrigger(Rule $rule): string;
|
|
|
|
|
2019-02-12 14:49:28 -06:00
|
|
|
public function getRuleActions(Rule $rule): Collection;
|
|
|
|
|
|
|
|
public function getRuleTriggers(Rule $rule): Collection;
|
|
|
|
|
2021-03-11 23:20:01 -06:00
|
|
|
/**
|
|
|
|
* Return search query for rule.
|
|
|
|
*/
|
|
|
|
public function getSearchQuery(Rule $rule): string;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get all the users rules that trigger on storage.
|
|
|
|
*/
|
|
|
|
public function getStoreRules(): Collection;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get all the users rules that trigger on update.
|
|
|
|
*/
|
|
|
|
public function getUpdateRules(): Collection;
|
|
|
|
|
2021-03-21 03:15:40 -05:00
|
|
|
public function maxOrder(RuleGroup $ruleGroup): int;
|
|
|
|
|
2021-03-11 23:20:01 -06:00
|
|
|
public function moveRule(Rule $rule, RuleGroup $ruleGroup, int $order): Rule;
|
|
|
|
|
2021-03-14 04:41:17 -05:00
|
|
|
public function resetRuleOrder(RuleGroup $ruleGroup): bool;
|
2016-01-14 02:38:48 -06:00
|
|
|
|
2021-03-11 23:20:01 -06:00
|
|
|
public function searchRule(string $query, int $limit): Collection;
|
|
|
|
|
2021-03-21 03:15:40 -05:00
|
|
|
public function setOrder(Rule $rule, int $newOrder): void;
|
|
|
|
|
2023-12-20 12:35:52 -06:00
|
|
|
public function setUser(null|Authenticatable|User $user): void;
|
2017-01-30 09:46:30 -06:00
|
|
|
|
2016-04-06 02:27:45 -05:00
|
|
|
public function store(array $data): Rule;
|
2016-01-14 14:34:17 -06:00
|
|
|
|
2016-04-06 02:27:45 -05:00
|
|
|
public function storeAction(Rule $rule, array $values): RuleAction;
|
2016-01-14 14:34:17 -06:00
|
|
|
|
2016-04-06 02:27:45 -05:00
|
|
|
public function storeTrigger(Rule $rule, array $values): RuleTrigger;
|
2016-01-20 08:23:36 -06:00
|
|
|
|
2016-04-06 02:27:45 -05:00
|
|
|
public function update(Rule $rule, array $data): Rule;
|
2016-01-22 00:35:28 -06:00
|
|
|
}
|