firefly-iii/app/Repositories/Rule/RuleRepositoryInterface.php

97 lines
2.8 KiB
PHP
Raw Normal View History

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
*
* 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.
2017-10-21 01:40:00 -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
* GNU Affero General Public License for more details.
2017-10-21 01:40:00 -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
*/
declare(strict_types=1);
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;
use FireflyIII\User;
2023-02-19 01:43:28 -06:00
use Illuminate\Contracts\Auth\Authenticatable;
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-04-06 02:27:45 -05:00
public function destroy(Rule $rule): bool;
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-04-06 02:27:45 -05:00
public function getHighestOrderInRuleGroup(RuleGroup $ruleGroup): int;
2016-01-14 14:34:17 -06:00
public function getPrimaryTrigger(Rule $rule): string;
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
}