feat(purchase): implement purchase limit enforcement and custom exception handling

app/Domains/Catalog/Resources/CatalogFeaturedItemResource.php

@@ -36,7 +36,6 @@ class CatalogFeaturedItemResource extends JsonResource
             'nombre' => $catalogItem->nombre,
             'descripcion' => $catalogItem->descripcion,
             'precio' => $catalogItem->precio,
-            'stock_tecnico' => $catalogItem->availableStock(),
             'maximum_addable_quantity' => $this->maximumAddable(
                 $catalogItem->availableStock(),
                 $remainingUserQuota,
@@ -50,9 +49,6 @@ class CatalogFeaturedItemResource extends JsonResource
                     'event_dates' => $variant->selectedEventDates()->map(fn ($eventDate): string => $eventDate->date->format('Y-m-d'))->values(),
                     'descripcion' => $variant->getDescription(),
                     'precio' => number_format($variant->getPrice(), 2, '.', ''),
-                    'stock_tecnico' => $catalogItem->inventory_policy === InventoryPolicy::Unlimited
-                        ? null
-                        : $variant->inventory->availableStock(),
                     'maximum_addable_quantity' => $this->maximumAddable(
                         $catalogItem->inventory_policy === InventoryPolicy::Unlimited
                             ? null

app/Domains/Catalog/Resources/CatalogItemDetailResource.php

@@ -38,10 +38,6 @@ class CatalogItemDetailResource extends JsonResource
             'max_units_per_user' => $this->max_units_per_user,
             'has_tickets' => $this->has_tickets,
             'attributes' => $this->attributesData(),
-            'stock_tecnico' => $this->when(
-                $selectedVariant === null,
-                fn () => $this->availableStock(),
-            ),
             'maximum_addable_quantity' => $this->when(
                 $selectedVariant === null,
                 fn () => $this->maximumAddable($this->availableStock()),
@@ -172,7 +168,6 @@ class CatalogItemDetailResource extends JsonResource
             'event_dates' => $eventDates->map(fn ($eventDate): string => $eventDate->date->format('Y-m-d'))->values(),
             'descripcion' => $variant->getDescription(),
             'precio' => number_format($variant->getPrice(), 2, '.', ''),
-            'stock_tecnico' => $this->variantStock($variant),
             'maximum_addable_quantity' => $this->maximumAddable($this->variantStock($variant)),
             'values' => $values,
         ];

app/Domains/Catalog/Resources/CatalogSearchItemResource.php

@@ -27,7 +27,6 @@ class CatalogSearchItemResource extends JsonResource
             'descripcion' => $this->descripcion,
             'precio' => $this->precio,
             'image' => $attachment?->getTemporaryUrl(1440),
-            'stock_tecnico' => $this->availableStock(),
             'maximum_addable_quantity' => $this->maximumAddable($this->availableStock()),
             'variants' => $this->visibleVariants()
                 ->map(fn (Variant $variant): array => [
@@ -38,9 +37,6 @@ class CatalogSearchItemResource extends JsonResource
                     'event_dates' => $variant->selectedEventDates()->map(fn ($eventDate): string => $eventDate->date->format('Y-m-d'))->values(),
                     'descripcion' => $variant->getDescription(),
                     'precio' => number_format($variant->getPrice(), 2, '.', ''),
-                    'stock_tecnico' => $this->inventory_policy === InventoryPolicy::Unlimited
-                        ? null
-                        : $variant->inventory?->availableStock(),
                     'maximum_addable_quantity' => $this->maximumAddable(
                         $this->inventory_policy === InventoryPolicy::Unlimited
                             ? null