refactor(stock): make expired reservations terminal

app/Domains/Cart/Controllers/CartController.php

@@ -86,4 +86,14 @@ class CartController extends Controller
             'message' => __('api.cart.item_removed'),
         ]);
     }
+
+    public function restart(Request $request, Tenant $tenant): CartResource
+    {
+        return CartResource::make(
+            $this->cartService->restartExpired($tenant, $request),
+        )->additional([
+            'code' => 'cart.restarted',
+            'message' => __('api.cart.restarted'),
+        ]);
+    }
 }

app/Domains/Cart/Services/CartService.php

@@ -4,7 +4,7 @@ namespace App\Domains\Cart\Services;
 
 use App\Domains\Auth\Models\User;
 use App\Domains\Cart\Models\Cart;
-use App\Domains\Catalog\Exceptions\StockReservationExpiredException;
+use App\Domains\Catalog\Models\StockReservation;
 use App\Domains\Catalog\Services\ExpireStockReservationsService;
 use App\Domains\Tenant\Models\Tenant;
 use Illuminate\Http\Request;
@@ -97,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');

app/Domains/Cart/routes/api.php

@@ -6,6 +6,7 @@ use Illuminate\Support\Facades\Route;
 Route::prefix('tenants/{tenant:codigo}')
     ->group(function (): void {
         Route::get('cart', [CartController::class, 'show']);
+        Route::post('cart/restart', [CartController::class, 'restart']);
         Route::post('cart/items', [CartController::class, 'addItem']);
         Route::patch('cart/items/{cartItem}', [CartController::class, 'updateItemQuantity']);
         Route::delete('cart/items/{cartItem}', [CartController::class, 'removeItem']);