@via-profit/ability 3.0.1 → 3.1.0

package/CHANGELOG.md

@@ -1,5 +1,70 @@
 # Changelog
 
+## [3.2.0] - 2026-x3-xx
+
+### Изменено
+
+- Метод `AbilityPolicy.parseAll()` переименован в `AbilityPolicy.fromJSONAll()`
+- Метод `AbilityPolicy.parse()` переименован в `AbilityPolicy.toJSON()`
+- Метод `AbilityRule.parse()` переименован в `AbilityRule.toJSON()`
+- Метод `AbilityRuleSet.parse()` переименован в `.toJSON()`
+
+## [3.1.0] - 2026-03-20
+
+### Добавлено
+
+- Реализован кэш
+  - Добавлен кэш-провайдер `AbilityCacheProvider` для реализации кастомного кэша
+  - Реализован и включён по умолчанию `AbilityInMemoryCache` (кэш в памяти)
+- Добавлена полноценная поддержка `environment` как третьего аргумента в:
+  - `resolver.resolve(action, resource, environment)`
+  - `resolver.enforce(action, resource, environment)`
+- Введена возможность использовать пути вида `env.*` в правилах политик.
+  - Пример: `"subject": "env.time.hour"`
+- Добавлена поддержка смешанных сравнений:
+  - `resource.*` ↔ `env.*`
+  - литерал ↔ `env.*`
+  - `env.*` ↔ литерал
+
+### Breaking changes
+
+Асинхронизация механизма проверки политик.
+Все методы, участвующие в цепочке вычисления разрешений, теперь возвращают `Promise`.
+
+#### Изменено
+
+- `AbilityRule.check(resource): Promise<AbilityMatch>`  
+  Ранее возвращал `AbilityMatch` синхронно.
+
+- `AbilityRuleSet.check(resource): Promise<AbilityMatch>`  
+  Теперь выполняет правила последовательно и асинхронно.
+
+- `AbilityPolicy.check(resource): Promise<AbilityMatch>`  
+  Асинхронно проверяет ruleSet в строгом порядке.
+
+- `AbilityResolver.resolve(action, resource): Promise<AbilityResult>`  
+  Теперь асинхронный метод, который дожидается выполнения всех политик.
+
+- `AbilityResolver.enforce(action, resource): Promise<void | never>`  
+  Теперь работает асинхронно.
+
+### Миграция
+
+1. Все вызовы `check()` должны быть обновлены:
+
+```ts
+await rule.check(resource);
+await ruleSet.check(resource);
+await policy.check(resource);
+```
+
+2. Все вызовы `resolver.resolve()` и `resolver.enforce()` теперь требуют `await`:
+
+```ts
+await resolver.resolve('order.update', resource);
+await resolver.enforce('order.update', resource);
+```
+
 ## [3.0.1] - 2026-03-19
 
 ## Добавлено