update readme,migrations,contracts

Author: rez1dent3

README.md

@@ -28,22 +28,22 @@ laravel-wallet - Easy work with virtual wallet.
 
 ### Support Policy
 
-| Version    | Laravel        | PHP       | Fixes      |
-|------------|----------------|-----------|------------|
-| 7.x        | ^6.0,^7.0,^8.0 | ^7.4,^8.0 | 6 Sep 2022 |
-| 8.x        | ^9.0           | ^8.0      | 1 Jun 2022 |
-| 9.x [LTS]  | ^9.0           | ^8.0      | 8 Aug 2023 |
+| Version    | Laravel        | PHP         | End of improvements | End of support |
+|------------|----------------|-------------|---------------------|----------------|
+| 7.x        | ^6.0,^7.0,^8.0 | 7.4,8.0,8.1 | 1 Mar 2022          | 6 Sep 2022     |
+| 8.x        | ^9.0           | 8.0,8.1     | 1 May 2022          | 1 Jun 2022     |
+| 9.x [LTS]  | ^9.0           | 8.0,8.1     | 1 Feb 2023          | 6 Nov 2023     |
 
 ### Upgrade Guide
 
 To perform the migration, you will be [helped by the instruction](https://bavix.github.io/laravel-wallet/#/upgrade-guide).
 
 ### Extensions
 
-| Extension | Description | 
-| ----- | ----- | 
-| [Swap](https://github.com/bavix/laravel-wallet-swap) | Addition to the laravel-wallet library for quick setting of exchange rates | 
-| [Warm Up](https://github.com/bavix/laravel-wallet-warmup) | Addition to the laravel-wallet library for refresh balance wallets | 
+| Extension                                                 | Description                                                                |
+|-----------------------------------------------------------|----------------------------------------------------------------------------|
+| [Swap](https://github.com/bavix/laravel-wallet-swap)      | Addition to the laravel-wallet library for quick setting of exchange rates |
+| [Warm Up](https://github.com/bavix/laravel-wallet-warmup) | Addition to the laravel-wallet library for refresh balance wallets         | 
 
 ### Usage
 Add the `HasWallet` trait and `Wallet` interface to model.
@@ -87,19 +87,52 @@ class User extends Model implements Customer
 }
 ```
 
-Add the `HasWallet` trait and `Product` interface to `Item` model.
+Add the `HasWallet` trait and interface to `Item` model.
+
+Starting from version 9.x there are two product interfaces:
+- For an unlimited number of products (`ProductLimitedInterface`);
+- For a limited number of products (`ProductInterface`);
+
+An example with an unlimited number of products:
+```php
+use Bavix\Wallet\Traits\HasWallet;
+use Bavix\Wallet\Interfaces\Customer;
+use Bavix\Wallet\Interfaces\ProductInterface;
+
+class Item extends Model implements ProductInterface
+{
+    use HasWallet;
+
+    public function getAmountProduct(Customer $customer)
+    {
+        return 100;
+    }
+
+    public function getMetaProduct(): ?array
+    {
+        return [
+            'title' => $this->title, 
+            'description' => 'Purchase of Product #' . $this->id,
+        ];
+    }
+}
+```
+
+Example with a limited number of products:
 ```php
 use Bavix\Wallet\Traits\HasWallet;
-use Bavix\Wallet\Interfaces\Product;
 use Bavix\Wallet\Interfaces\Customer;
+use Bavix\Wallet\Interfaces\ProductLimitedInterface;
 
-class Item extends Model implements Product
+class Item extends Model implements ProductLimitedInterface
 {
     use HasWallet;
 
     public function canBuy(Customer $customer, int $quantity = 1, bool $force = false): bool
     {
         /**
+         * This is where you implement the constraint logic. 
+         * 
          * If the service can be purchased once, then
          *  return !$customer->paid($this);
          */
@@ -121,6 +154,10 @@ class Item extends Model implements Product
 }
 ```
 
+I do not recommend using the limited interface when working with a shopping cart. 
+If you are working with a shopping cart, then you should override the `PurchaseServiceInterface` interface. 
+With it, you can check the availability of all products with one request, there will be no N-queries in the database.
+
 Proceed to purchase.
 
 ```php
@@ -132,7 +169,7 @@ $user->pay($item); // If you do not have enough money, throw an exception
 var_dump($user->balance); // 0
 
 if ($user->safePay($item)) {
-  // try to buy again )
+  // try to buy again
 }
 
 var_dump((bool)$user->paid($item)); // bool(true)
@@ -144,7 +181,11 @@ var_dump((bool)$user->paid($item)); // bool(false)
 ### Eager Loading
 
 ```php
+// When working with one wallet
 User::with('wallet');
+
+// When using the multi-wallet functionality
+User::with('wallets');
 ```
 
 ### How to work with fractional numbers?

database/2018_11_06_222923_create_transactions_table.php

@@ -7,8 +7,7 @@
 use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
 
-class CreateTransactionsTable extends Migration
-{
+return new class() extends Migration {
     public function up(): void
     {
         Schema::create($this->table(), function (Blueprint $table) {
@@ -42,4 +41,4 @@ private function table(): string
     {
         return (new Transaction())->getTable();
     }
-}
+};

database/2018_11_07_192923_create_transfers_table.php

@@ -8,8 +8,7 @@
 use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
 
-class CreateTransfersTable extends Migration
-{
+return new class() extends Migration {
     public function up(): void
     {
         Schema::create($this->table(), function (Blueprint $table) {
@@ -70,4 +69,4 @@ private function transactionTable(): string
     {
         return (new Transaction())->getTable();
     }
-}
+};

database/2018_11_15_124230_create_wallets_table.php

@@ -8,8 +8,7 @@
 use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
 
-class CreateWalletsTable extends Migration
-{
+return new class() extends Migration {
     public function up(): void
     {
         Schema::create($this->table(), function (Blueprint $table) {
@@ -63,4 +62,4 @@ private function transactionTable(): string
     {
         return (new Transaction())->getTable();
     }
-}
+};

database/2021_11_02_202021_update_wallets_uuid_table.php

@@ -9,16 +9,15 @@
 use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\Schema;
 
-class UpdateWalletsUuidTable extends Migration
-{
+return new class() extends Migration {
     public function up(): void
     {
         if (Schema::hasColumn($this->table(), 'uuid')) {
             return;
         }
 
         // upgrade from 6.x
-        Schema::table($this->table(), function (Blueprint $table) {
+        Schema::table($this->table(), static function (Blueprint $table) {
             $table->uuid('uuid')
                 ->after('slug')
                 ->nullable()
@@ -49,4 +48,4 @@ protected function table(): string
     {
         return (new Wallet())->getTable();
     }
-}
+};

src/Internal/Repository/WalletRepository.php

@@ -6,14 +6,12 @@
 
 use Bavix\Wallet\Internal\Exceptions\ExceptionInterface;
 use Bavix\Wallet\Internal\Exceptions\ModelNotFoundException;
-use Bavix\Wallet\Internal\Service\UuidFactoryServiceInterface;
 use Bavix\Wallet\Models\Wallet;
 use Illuminate\Database\Eloquent\ModelNotFoundException as EloquentModelNotFoundException;
 
 final class WalletRepository implements WalletRepositoryInterface
 {
     public function __construct(
-        private UuidFactoryServiceInterface $uuidFactoryService,
         private Wallet $wallet
     ) {
     }
@@ -69,7 +67,7 @@ public function getById(int $id): Wallet
     public function getByUuid(string $uuid): Wallet
     {
         return $this->getBy([
-            'uuid' => $this->uuidFactoryService->cast($uuid),
+            'uuid' => $uuid,
         ]);
     }
 

src/Internal/Service/StorageService.php

@@ -44,21 +44,16 @@ public function get(string $key): string
         return $this->mathService->round($value);
     }
 
-    /**
-     * @param float|int|string $value
-     */
-    public function sync(string $key, $value): bool
+    public function sync(string $key, float|int|string $value): bool
     {
         return $this->cacheRepository->set($key, $value);
     }
 
     /**
-     * @param float|int|string $value
-     *
      * @throws LockProviderNotFoundException
      * @throws RecordNotFoundException
      */
-    public function increase(string $key, $value): string
+    public function increase(string $key, float|int|string $value): string
     {
         return $this->lockService->block(
             $key.'::increase',

src/Internal/Service/StorageServiceInterface.php

@@ -18,16 +18,11 @@ public function missing(string $key): bool;
      */
     public function get(string $key): string;
 
-    /**
-     * @param float|int|string $value
-     */
-    public function sync(string $key, $value): bool;
+    public function sync(string $key, float|int|string $value): bool;
 
     /**
-     * @param float|int|string $value
-     *
      * @throws LockProviderNotFoundException
      * @throws RecordNotFoundException
      */
-    public function increase(string $key, $value): string;
+    public function increase(string $key, float|int|string $value): string;
 }

src/Internal/Service/UuidFactoryService.php

@@ -19,9 +19,4 @@ public function uuid4(): string
             ->toString()
         ;
     }
-
-    public function cast(string $uuid): string
-    {
-        return $uuid;
-    }
 }

src/Internal/Service/UuidFactoryServiceInterface.php

@@ -7,6 +7,4 @@
 interface UuidFactoryServiceInterface
 {
     public function uuid4(): string;
-
-    public function cast(string $uuid): string;
 }