refactor(stock): make expired reservations terminal

app/Domains/Cart/Services/CartService.php

@@ -4,9 +4,12 @@ namespace App\Domains\Cart\Services;
 
 use App\Domains\Auth\Models\User;
 use App\Domains\Cart\Models\Cart;
+use App\Domains\Catalog\Models\StockReservation;
+use App\Domains\Catalog\Services\ExpireStockReservationsService;
 use App\Domains\Tenant\Models\Tenant;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Auth;
+use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Str;
 use Illuminate\Validation\ValidationException;
 use Symfony\Component\HttpFoundation\Cookie;
@@ -94,6 +97,45 @@ class CartService
         return $this->loadCart($cart, $tenant);
     }
 
+    public function restartExpired(Tenant $tenant, Request $request): Cart
+    {
+        $identity = $this->requireIdentity($request);
+        $cart = $this->findCartOrFail($tenant, $identity);
+        if ($cart->current_stock_reservation_id === null
+            || ! app(ExpireStockReservationsService::class)
+                ->expireIfOverdue($cart->current_stock_reservation_id)) {
+            throw ValidationException::withMessages([
+                'cart' => __('api.cart.reservation_not_expired'),
+            ]);
+        }
+
+        $newCart = DB::transaction(function () use ($cart, $identity, $tenant): Cart {
+            /** @var Cart $cart */
+            $cart = Cart::query()->lockForUpdate()->findOrFail($cart->getKey());
+            /** @var StockReservation|null $reservation */
+            $reservation = $cart->current_stock_reservation_id === null
+                ? null
+                : StockReservation::query()
+                    ->lockForUpdate()
+                    ->find($cart->current_stock_reservation_id);
+
+            if ($reservation?->status !== StockReservation::STATUS_EXPIRED) {
+                throw ValidationException::withMessages([
+                    'cart' => __('api.cart.reservation_not_expired'),
+                ]);
+            }
+
+            $cart->update([
+                'status' => 'abandoned',
+                'current_purchase_id' => null,
+            ]);
+
+            return $this->findOrCreateCart($tenant, $identity);
+        });
+
+        return $this->loadCart($newCart, $tenant);
+    }
+
     public function makeGuestTokenCookie(string $guestToken): Cookie
     {
         $secure = (bool) config('session.secure');