update docs

Author: rez1dent3

changelog.md

@@ -6,6 +6,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [8.1.0] - 2022-03-13
+### Removed
+- Method `getAvailableBalance`.
+
+### Added
+- Methods `withItems`, `withItem`, `withMeta` on Cart-object.
+
+### Deprecated
+- Method `addItems`, `addItem`, `setMeta` on Cart-Object.
+
 ## [8.0.6] - 2022-02-26
 ### Updated
 - Replaced an object with an interface (Events) #444 @ysfkaya
@@ -801,7 +811,8 @@ The operation is now executed in the transaction and updates the new `refund` fi
 - Exceptions: AmountInvalid, BalanceIsEmpty.
 - Models: Transfer, Transaction.
 
-[Unreleased]: https://github.com/bavix/laravel-wallet/compare/8.0.6...develop
+[Unreleased]: https://github.com/bavix/laravel-wallet/compare/8.1.0...develop
+[8.0.6]: https://github.com/bavix/laravel-wallet/compare/8.0.6...8.1.0
 [8.0.6]: https://github.com/bavix/laravel-wallet/compare/8.0.5...8.0.6
 [8.0.5]: https://github.com/bavix/laravel-wallet/compare/8.0.4...8.0.5
 [8.0.4]: https://github.com/bavix/laravel-wallet/compare/8.0.3...8.0.4

docs/upgrade-guide.md

@@ -194,3 +194,33 @@ On a basket of 150 products, the acceleration is a whopping 24x.
 All changes can be found in the [pull request](https://github.com/bavix/laravel-wallet/pull/407/files). 
 The kernel has changed globally, I would not recommend switching to version 7.0.0 at the very beginning, there may be bugs. 
 I advise you should at least 7.0.1.
+
+## 7.x.x → 8.0.x
+
+Nothing needs to be done.
+
+## 8.0.x → 8.1.x
+
+Replace `getAvailableBalance` to `getAvailableBalanceAttribute` (method) or `available_balance` (property).
+
+---
+
+Cart methods now support fluent-dto. It is necessary to replace the old code with a new one, for example:
+
+```php
+// old
+$cart = app(\Bavix\Wallet\Objects\Cart::class)
+    ->addItems($products)
+    ->addItem($product)
+    ->setMeta(['hello' => 'world']);
+    
+$cart->addItem($product);
+
+// new. fluent
+$cart = app(\Bavix\Wallet\Objects\Cart::class)
+    ->withItems($products)
+    ->withItem($product)
+    ->withMeta(['hello' => 'world']);
+
+$cart = $cart->withItem($product);
+```